diff --git a/examples/dart/test/app_services_test.dart b/examples/dart/test/app_services_test.dart index 2765f7e07f..31450211f7 100644 --- a/examples/dart/test/app_services_test.dart +++ b/examples/dart/test/app_services_test.dart @@ -47,8 +47,8 @@ void main() { test('Change BaseUrl', () async { // :snippet-start: change-base-url // Specify a custom baseUrl to connect to. - // In this case, an Edge Server instance running on the device. - final appConfig = AppConfiguration(edgeServerAppId, + // In this case, an custom server instance running on the device. + final appConfig = AppConfiguration(customServerAppId, baseUrl: Uri.parse('http://localhost:80')); var app = App(appConfig); diff --git a/source/examples/generated/flutter/app_services_test.snippet.change-base-url.dart b/source/examples/generated/flutter/app_services_test.snippet.change-base-url.dart index a4cbca41bf..9506b7aebb 100644 --- a/source/examples/generated/flutter/app_services_test.snippet.change-base-url.dart +++ b/source/examples/generated/flutter/app_services_test.snippet.change-base-url.dart @@ -1,6 +1,6 @@ // Specify a custom baseUrl to connect to. -// In this case, an Edge Server instance running on the device. -final appConfig = AppConfiguration(edgeServerAppId, +// In this case, an custom server instance running on the device. +final appConfig = AppConfiguration(customServerAppId, baseUrl: Uri.parse('http://localhost:80')); var app = App(appConfig); diff --git a/source/index.txt b/source/index.txt index 982f862d4e..b16379177d 100644 --- a/source/index.txt +++ b/source/index.txt @@ -35,8 +35,8 @@ Welcome to the Atlas Device SDK Docs .. introduction:: Atlas Device SDK is a suite of app development tools optimized for - data access and persistence on mobile and edge devices. Use the SDKs to - build data-driven mobile, edge, web, desktop, and IoT apps. + data access and persistence on mobile devices. Use the SDKs to + build data-driven mobile, web, desktop, and IoT apps. .. button:: Get started with a tutorial :uri: https://mongodb.com/docs/atlas/app-services/get-started/ diff --git a/source/sdk/dotnet/app-services/connect-to-app-services-backend.txt b/source/sdk/dotnet/app-services/connect-to-app-services-backend.txt index 46003b0c83..4f81bfd9f2 100644 --- a/source/sdk/dotnet/app-services/connect-to-app-services-backend.txt +++ b/source/sdk/dotnet/app-services/connect-to-app-services-backend.txt @@ -62,7 +62,6 @@ connect to a different server: - Your App Services App uses :ref:`local deployment `, and you want to connect directly to a local ``baseURL`` in your region. -- You want to connect to an :ref:`Edge Server instance `. You can specify a ``baseURL`` in the :dotnet-sdk:`AppConfiguration `. @@ -76,8 +75,7 @@ Connect to a Different Server During Runtime .. versionadded:: 12.1.0 In some cases, you might want to change the ``baseURL`` while the app is -running. For example, you might want to roam between Edge Servers, or -move from an App Services connection to an Edge Server connection. To change +running. To change the ``baseURL`` during runtime, call the :dotnet-sdk:`app.UpdateBaseUriAsync() ` method: diff --git a/source/sdk/flutter/app-services/connect-to-app.txt b/source/sdk/flutter/app-services/connect-to-app.txt index a744e181ec..e07b8ff6f3 100644 --- a/source/sdk/flutter/app-services/connect-to-app.txt +++ b/source/sdk/flutter/app-services/connect-to-app.txt @@ -127,9 +127,8 @@ 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: -- Your App Services App uses local deployment, and you want to connect directly to a local ``baseUrl`` in your region. For more information, refer to the :ref:`` App Services documentation. -- You want to connect to an Edge Server instance. For more information, refer to - the :ref:`edge-server-connect-from-client` App Services documentation. +- Your App Services App uses local deployment, and you want to connect directly to a local ``baseUrl`` in your region. +For more information, refer to the :ref:`` App Services documentation. You can specify a ``baseUrl`` in the :flutter-sdk:`AppConfiguration `: @@ -145,8 +144,7 @@ Connect to a Different Server During Runtime ``updateBaseUrl`` accepts ``null`` value In some cases, you might want to change the ``baseUrl`` while the app is -running. For example, you might want to roam between Edge Servers or -move from an App Services connection to an Edge Server connection. +running. To change the ``baseUrl`` during runtime, call the experimental :flutter-sdk:`app.updateBaseUrl ` method. You can diff --git a/source/sdk/kotlin/app-services/connect-to-app-services-backend.txt b/source/sdk/kotlin/app-services/connect-to-app-services-backend.txt index 2534f1cb13..c0389497f0 100644 --- a/source/sdk/kotlin/app-services/connect-to-app-services-backend.txt +++ b/source/sdk/kotlin/app-services/connect-to-app-services-backend.txt @@ -270,9 +270,8 @@ 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: -- Your App Services App uses local deployment, and you want to connect directly to a local ``baseUrl`` in your region. For more information, refer to the :ref:`` App Services documentation. -- You want to connect to an Edge Server instance. For more information, refer to - the :ref:`edge-server-connect-from-client` App Services documentation. +- Your App Services App uses local deployment, and you want to connect directly to a local ``baseUrl`` in your region. +For more information, refer to the :ref:`` App Services documentation. You can specify a ``baseUrl`` in the `AppConfiguration <{+kotlin-sync-prefix+}io.realm.kotlin.mongodb/-app-configuration/index.html>`__: @@ -286,8 +285,7 @@ Connect to a Different Server During Runtime .. versionadded:: 1.16.0 In some cases, you might want to change the ``baseUrl`` while the app is -running. For example, you might want to roam between Edge Servers or -move from an App Services connection to an Edge Server connection. +running. To change the ``baseUrl`` during runtime, call the experimental `app.updateBaseUrl <{+kotlin-sync-prefix+}io.realm.kotlin.mongodb/-app/index.html#2007791704%2FFunctions%2F380376748>`__ method. You can @@ -296,13 +294,6 @@ pass ``null`` to reset the ``baseUrl`` to the default value. .. literalinclude:: /examples/generated/kotlin/AppClientTest.snippet.change-base-url.kt :language: kotlin -This API is experimental and requires the `@ExperimentalEdgeServerApi -<{+kotlin-sync-prefix+}io.realm.kotlin.mongodb.annotations/-experimental-edge-server-api/index.html>`__ -annotation: - -.. literalinclude:: /examples/generated/kotlin/AppClientTest.snippet.experimental-opt-in.kt - :language: kotlin - If you change the ``baseUrl`` *after* you have logged in a user and have opened a synced database, the app must perform a client reset. For more information, refer to :ref:`kotlin-client-reset`. diff --git a/source/sdk/node/app-services/connect-to-app-services-backend.txt b/source/sdk/node/app-services/connect-to-app-services-backend.txt index 08adb68f4f..3b68d9f8d7 100644 --- a/source/sdk/node/app-services/connect-to-app-services-backend.txt +++ b/source/sdk/node/app-services/connect-to-app-services-backend.txt @@ -149,7 +149,6 @@ connect to a different server: - Your App Services App uses :ref:`local deployment `, and you want to connect directly to a local ``baseURL`` in your region. -- You want to connect to an :ref:`Edge Server instance `. You can specify a ``baseURL`` in the :js-sdk:`AppConfiguration `: @@ -176,8 +175,7 @@ Connect to a Different Server During Runtime .. versionadded:: 12.8.0 In some cases, you might want to change the ``baseURL`` while the app is -running. For example, you might want to roam between Edge Servers, or -move from an App Services connection to an Edge Server connection. +running. To change the ``baseURL`` during runtime, call the ``app.updateBaseUrl()`` method. Note that the string value can't end in a trailing slash. diff --git a/source/sdk/react-native/app-services/connect-to-app-services-app.txt b/source/sdk/react-native/app-services/connect-to-app-services-app.txt index 47c621c401..cae1eccec8 100644 --- a/source/sdk/react-native/app-services/connect-to-app-services-app.txt +++ b/source/sdk/react-native/app-services/connect-to-app-services-app.txt @@ -106,7 +106,6 @@ connect to a different server: - Your App Services App uses :ref:`local deployment `, and you want to connect directly to a local ``baseURL`` in your region. -- You want to connect to an :ref:`Edge Server instance `. You can specify a ``baseURL`` as a prop for :ref:`AppProvider `. All :js-sdk:`AppConfiguration ` keys can be @@ -118,8 +117,7 @@ Connect to a Different Server During Runtime .. versionchanged:: ``realm@12.8.0`` In some cases, you might want to change the ``baseURL`` while the app is -running. For example, you might want to roam between Edge Servers, or -move from an App Services connection to an Edge Server connection. +running. Currently, this feature is implemented as an experimental module that requires specific TypeScript configuration. The required configuration can be difficult diff --git a/source/sdk/swift/app-services/connect-to-app-services-backend.txt b/source/sdk/swift/app-services/connect-to-app-services-backend.txt index 93e1115523..a09b410b02 100644 --- a/source/sdk/swift/app-services/connect-to-app-services-backend.txt +++ b/source/sdk/swift/app-services/connect-to-app-services-backend.txt @@ -115,7 +115,6 @@ connect to a different server: - Your App Services App uses :ref:`local deployment `, and you want to connect directly to a local ``baseURL`` in your region. -- You want to connect to an :ref:`Edge Server instance `. You can specify a ``baseURL`` in the :swift-sdk:`AppConfiguration `: @@ -129,8 +128,7 @@ Connect to a Different Server During Runtime .. versionadded:: 10.50.0 In some cases, you might want to change the ``baseURL`` while the app is -running. For example, you might want to roam between Edge Servers, or -move from an App Services connection to an Edge Server connection. To change +running. To change the ``baseURL`` during runtime, call the ``app.updateBaseUrl(to: )`` method: .. literalinclude:: /examples/generated/code/start/RealmApp.snippet.change-base-url.swift