Conectar-se ao App Services - Flutter SDK

Antes de começar

1. Criar um App Services App

2. Encontre o ID do aplicativo na UI do App Services

Acesse o cliente do aplicativo

Crie uma instância do App para acessar as funcionalidades do App Services em todo o seu aplicativo cliente. Recomendamos que você crie a instância App apenas uma vez no isolado principal, de preferência assim que o aplicativo for iniciado.

1. Obtenha App Services App ID o do seu aplicativo de serviços de aplicativos na interface do usuário do Services. Para saber como, consulte Encontrar o ID do seu aplicativo.

2. Criar um AppConfiguration objeto com o ID do aplicativo do seu aplicativo como argumento.

3. Criar um aplicativo com o que AppConfiguration você acabou de criar. Em Flutter v1.7.0 e, posteriormente, isso deve ser feito no isolamento principal, caso contrário, o SDK gerará um erro.

Depois de criar o App, você pode acessar a instância App construída em um background isolado usando App.getById. Consulte a seção Obter aplicativo por ID nesta página para obter mais informações.

final appConfig = AppConfiguration(appId);
final app = App(appConfig);

Você pode criar várias instâncias do cliente de aplicativo para se conectar a vários aplicativos. Todas as instâncias de cliente de aplicativo que compartilham a mesma ID de aplicativo usam a mesma conexão subjacente.

Configuração avançada

Você pode adicionar argumentos opcionais ao AppConfiguration para um controle mais granular do seu cliente App . Talvez você queira adicionar coisas como tempos limite personalizados para conexões ou chaves para criptografia de metadados local. Para saber mais sobre as opções de configuração disponíveis, consulte a AppConfiguration documentação de referência.

final appConfig = AppConfiguration(appId,
    defaultRequestTimeout: const Duration(seconds: 120)
    // ... see reference docs for all available configuration options
    );

Obter aplicativo por ID

Depois de criar uma App instância no isolamento principal, você pode acessar a instância construída em um isolamento do background passando o ID do aplicativo para o App.getById() método. Em seguida, você pode usá-lo para trabalhar com o App e os usuários conforme necessário.

// Create an App instance once on main isolate,
// ideally as soon as the app starts
final appConfig = AppConfiguration(appId);
final app = App(appConfig);
final receivePort = ReceivePort();
// Later, access the App instance on background isolate
await Isolate.spawn((List<Object> args) async {
  final sendPort = args[0] as SendPort;
  final appId = args[1] as String;
  try {
    final backgroundApp = App.getById(appId); 
    // ... Access App users
    final user = backgroundApp?.currentUser!;
    // Use the App and user as needed.
    sendPort.send('Background task completed');
  } catch (e) {
    sendPort.send('Error: $e');
  }
}, [receivePort.sendPort, appId]);

Conecte-se a um servidor MongoDB específico

Por padrão, o Atlas Device SDK se conecta ao Atlas usando o baseUrl global de https://services.cloud.mongodb.com. Em alguns casos, você pode querer se conectar a um servidor diferente:

• Seu App Services App usa o sistema local e você deseja se conectar diretamente a um baseUrl local em sua região.

Para obter mais informações, consulte a documentação do Local Deployment App Services.

Você pode especificar um baseUrl no AppConfiguration:

// Specify a baseUrl to connect to a server other than the default
final appConfig =
    AppConfiguration(appId, baseUrl: Uri.parse('https://example.com'));
var app = App(appConfig);

// Specify a custom baseUrl to connect to.
// In this case, a custom server instance running on the device.
final appConfig = AppConfiguration(customServerAppId,
    baseUrl: Uri.parse('http://localhost:80'));
var app = App(appConfig);
// ... log in a user and use the app ...
// Later, change the baseUrl to the default:
// https://services.cloud.mongodb.com
await app.updateBaseUrl(null);