Connect to App Services - Flutter SDK

Antes de comenzar

1. Crear una aplicación de servicios de aplicaciones

2. Find the App ID in the App Services UI

Access the App Client

Create an App instance to access App Services features throughout your client application. We recommend that you create the App instance only once on the main isolate, ideally as soon as the app starts.

1. Obtén el ID de tu App de Servicios de aplicaciones desde la Interfaz de usuario Realm. Para saber cómo, consulta Encuentra tu ID de la aplicación.

2. Crear una AppConfiguration objeto con el ID de aplicación de su aplicación como argumento.

3. Crea una Aplicación con el AppConfiguration que acabas de crear. En Flutter v1.7.0 y más adelante, esto debe hacerse en el aislado principal, de lo contrario el SDK arroja un error.

Después de App crear, puede acceder a la App instancia construida en un aislamiento en segundo plano App.getById mediante. Consulte la sección "Obtener aplicación por ID" en esta página para obtener más información.

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

Puedes crear varias instancias de un cliente de aplicación para conectarte a múltiples aplicaciones. Todas las instancias de cliente de aplicación que comparten el mismo ID de la aplicación utilizan la misma conexión subyacente.

Configuración avanzada

You can add optional arguments to the AppConfiguration for more granular control of your App client. You may want to add things like custom timeouts for connections or keys for local metadata encryption. To learn about the available configuration options, refer to the AppConfiguration reference documentation.

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

Obtener aplicación por ID

After you have created an App instance on the main isolate, you can access the constructed instance on a background isolate by passing the App ID to the App.getById() method. Then, you can use it to work with the App and users as needed.

// 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]);

Conectar a un servidor específico

By default, Atlas Device SDK connects to Atlas using the global baseUrl of https://services.cloud.mongodb.com. In some cases, you may want to connect to a different server:

• Tu aplicación de App Services utiliza una implementación local y quieres conectarte directamente a un baseUrl local en tu región.

Para obtener más información, consulte la documentación de Servicios de aplicaciones de implementación local.

You can specify a baseUrl in the 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);