App Services への接続 - Flutter SDK

始める前に

1. App Services アプリの作成

2. App Services UI でアプリケーション ID を見つける

アプリ クライアントへのアクセス

クライアント アプリケーション全体で App Services 機能にアクセスするには、 Appインスタンスを作成します。 Appインスタンスは、メイン分離で 1 回だけ、できればアプリの起動後すぐに作成することをお勧めします。

1. App Services UI からApp Services AppのIDを取得します。 その方法については、 「 アプリ ID を検索する 」を参照してください。

2. AppConfiguration の作成 アプリのアプリ ID を引数として持つオブジェクト。

3. アプリ AppConfigurationを作成する 作成した に置き換えます。Flutter v 1 . 7 。 0 以降では、これはメインの分離で実行する必要があります。そうでない場合、SDK はエラーをスローします。

Appを作成したら、 App.getByIdを使用してバックグラウンド分離で構築されたAppインスタンスにアクセスできます。 詳細については、このページの「 ID によるアプリの取得 」セクションを参照してください。

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

複数のアプリに接続するには、複数のアプリクライアントインスタンスを作成します。 同じアプリ ID を共有するすべてのアプリクライアント インスタンスは、同じ基礎の接続を使用します。

高度な構成

Appクライアントをより細かく制御するために、 AppConfigurationにオプションの引数を追加できます。 接続のカスタム タイムアウトやローカル メタデータの暗号化のキーなど、さまざまな機能を追加することができます。 使用可能な構成オプションの詳細については、 AppConfiguration を参照してください 参照ドキュメント。

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

ID でアプリを取得

Appメイン分離で インスタンスを作成したら、アプリ ID を App.getById() に渡すことで、バックグラウンド分離で構築された インスタンスにアクセスできます。 使用して複数のドキュメントを挿入できます。その後、必要に応じてAppユーザーとユーザーを操作するために使用できます。

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

特定のサーバーへの接続

デフォルトでは、Atlas Device SDK はhttps://services.cloud.mongodb.comのグローバルbaseUrlを使用して Atlas に接続します。 場合によっては、別のサーバーに接続する必要があるかもしれません。

• App Services Appはローカル配置を使用しており、リージョン内のローカル baseUrl に直接接続する場合があります。 詳しくは、「 App Services をローカル配置した場合 」のドキュメントを参照してください。

• Edge Server インスタンスに接続する場合。 詳細については、「 Atlas Device SDK App Services から Edge Server への接続」ドキュメントを参照してください。

AppConfiguration で を指定できます。baseUrl

// 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, an Edge Server instance running on the device.
final appConfig = AppConfiguration(edgeServerAppId,
    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);