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. Crie um objeto AppConfiguration com o ID do aplicativo do seu aplicativo como argumento.

3. Crie um aplicativo com o que AppConfiguration você acabou de criar. No Flutter v..1 70 e posterior, 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 App cliente. 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 documentação de referência do AppConfiguration.

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 a ID do aplicativo para o método App.getById(). 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);