模板应用程序

您可以使用与创建空白应用相同的命令创建模板应用。要了解如何创建 App Services App，请参阅创建应用并按照模板应用的说明进行操作。

创建模板应用后，用户界面会包含 Get the Front-End Code for your Template 部分，其中提供客户端代码，您可以将客户端代码下载为 .zip文件、在Github上查看或通过App Services CLI获取。

您可以使用与创建空白应用相同的命令创建模板应用。要了解如何创建 App Services App，请参阅创建应用并按照模板应用的说明进行操作。

该命令必须包含具有有效模板应用ID值的--template标志：

appservices apps create \
  --name "<App Name>" \
  --template "<Template App ID>"

您可以使用与创建空白应用相同的端点创建模板应用。 要学习；了解如何创建App Services App，请参阅创建应用并按照模板应用的说明进行操作。

您的 Admin API 请求必须在请求正文中包含有效的template_id值。

curl -X POST \
  https://services.cloud.mongodb.com/api/admin/v3.0/groups/{groupId}/apps \
  -H 'Authorization: Bearer <access_token>' \
  -d '{
    "name": "<App Name>",
    "template_id": "<Template App ID>",
    "data_source": {
      "name": "mongodb-atlas",
      "type": "mongodb-atlas",
      "config": {
        "clusterName": "<Atlas Cluster Name>"
      }
    }
  }'

通过 App Services 用户界面下载客户端代码时，客户端代码不会预先填充 App Services App ID。要使用其中一个客户端，您必须找到要在客户端中使用的应用 ID。按照客户端 README.md 中的 Configuration 和 Download the Client as a Zip File 说明来了解在何处插入 App ID。

创建模板应用时下载客户端

当您使用Atlas App Services用户界面创建模板应用时，用户界面为您提供了三个选项，以便您在创建模板后立即获取客户端代码：

• 将您的首选客户端下载为 .zip 文件。

• 使用 App Services CLI 将首选客户端拉取到本地目录。

• 从Github查看并克隆客户端代码。

选择首选方法后，按照屏幕上的说明操作或克隆存储库以获取客户端代码。

在创建模板应用后的某个时间点下载客户端

如果在首次创建应用时未下载客户端代码，您可以稍后下载。 您的App Services App在主仪表盘上显示“Welcome to Your Application”（欢迎来到您的应用程序）窗格。 此窗格包含一个标签为</> Pull front-end code的按钮。 单击此按钮时，您会看到与首次创建应用时相同的对话框，其中提供了获取客户端的选项。

当您通过 App Services CLI 下载客户端代码时，客户端代码会预先填充您的 App Services App ID。

创建模板应用时下载客户端

当您使用App Services CLI创建模板应用时，它会在您运行创建命令的所有位置自动创建一个包含后端和客户端代码的目录。 或者，您可以使用--local选项指定应用代码下载到的目录。

appservices apps create -n "<App Name>" --template "<Chosen Template App ID>"

目录名称是应用的名称。 在此目录中，您将看到一个包含App Services代码的backend目录，以及一个包含客户端应用程序代码的frontend目录。

在创建模板应用后的某个时间点下载客户端

创建模板应用后，您可以随时使用App Services CLI下载客户端代码。 使用带有--template选项的App Services CLI pull 命令指定要下载的客户端模板。

appservices pull --remote "<App Name>" --template "<Chosen Template App ID>"

使用ID提供客户端应用程序的可用模板的 ID。

Device Sync模板应用客户端可从Github获取。 如果您只需要客户端代码而不需要后端代码，请浏览与您的首选框架或语言相关的Github存储库：

• C++ Device Sync 客户端

• Flutter Device Sync客户端

• Kotlin Device Sync客户端

• Maui Device Sync客户端

• React Native Device Sync客户端

• SwiftUI Device Sync客户端

如果克隆这些存储库之一，则客户端代码不会预先填充您的 App Services App ID。 要使用其中一个客户端，您必须创建模板应用并找到要在客户端中使用的 App ID 。 按照客户端README.md中的Configuration和Cloning from GitHub说明来了解在何处插入 App ID。