AGC平台创建端云一体化开发工程全攻略

视频课程学习报名入口：HarmonyOS NEXT端云一体化开发

端云一体化开发工程创建方式有两种，一种是先在AGC平台创建HarmonyOS应用/元服务，然后使用DevEco Studio的通用云开发模板创建HarmonyOS应用/元服务并关联云开发资源；另一种是使用DevEco Studio的通用云开发模板创建HarmonyOS应用/元服务工程，在关联云资源时根据提示在AGC平台创建HarmonyOS应用/元服务，然后再关联云开发资源。无论选择哪种方式，开发者都可以通过DevEco Studio和AGC平台的紧密集成，快速实现端云一体化的开发，提升开发效率和应用的云服务能力。

应用场景与选择建议

• 方式一 适用于开发者已经明确需要在AGC平台创建应用/元服务，并且希望在工程创建时直接关联云资源的场景。这种方式适合对AGC平台较为熟悉的开发者，或者项目初期已经规划好云资源使用的情况。

• 方式二 适用于开发者希望在工程创建过程中逐步完成AGC平台应用/元服务的创建和云资源关联的场景。这种方式适合对AGC平台不太熟悉，或者希望在工程创建过程中灵活调整云资源使用的开发者。

AGC平台已有应用适配端云一体化能力

1）步骤一： 登录AGC平台，点击“证书、APP ID和Profile”卡片。

2）步骤二： 点击左侧菜单栏中的“APP ID”打开应用列表页面，点击“新建”按钮打开应用创建页面。

3）步骤三： 在“设置应用开发基础信息”页面，填写应用基础信息，完成后点击“下一步”按钮。

参数	说明
应用类型	确定需要创建的应用形态：HarmonyOS应用或元服务
应用名称	应用/元服务在应用市场展示的名称
应用包名	仅当应用类型为HarmonyOS时，才需要在此处手动填写包名；元服务包名会在元服务创建成功后自动生成
应用分类	普通应用或游戏类应用，设置后不支持修改，请慎重选择

4）步骤四： 在“开放能力接入”页面，为应用/元服务选择所属的项目，若将应用/元服务添加到已有项目，点击下拉框进行选择。若为新项目，则直接在输入框中填写新项目名称即可。完成后点击“确定”按钮，应用/元服务即成功创建。

5）步骤五： （可选）若应用/元服务需要使用华为账号、导航服务等开放能力，则必须在AGC平台打开对应能力的开关。在“开放能力”栏搜索需要接入的开放能力，打开该能力所在行的开关，点击“确认”即可。

6）步骤六： 返回“APP ID”页面，可查看已创建的APP ID、应用名称与包名信息。

7）步骤七： 选择一种方式，打开工程创建向导界面。

• 如果当前尚未打开任何工程，点击DevEco Studio欢迎页中“Create Project”打开工程创建向导界面。
  
• 如果已经打开了工程，可以在菜单栏选择“File > New > Create Project”打开工程创建向导界面。
  
  8）步骤八： 在选择模板界面，在“Application/Atomic Service”页签，选择通用云开发模板([CloudDev]Empty Ability)，然后点击“Next”按钮。

9）步骤九： 在工程配置界面，配置工程的基本信息。配置完成后，点击“Next”按钮，进入关联云开发资源界面。

参数	说明
Project name	工程的名称，由大小写字母、数字和下划线组成
Bundle name	软件包名称，需保证唯一，且需与AGC创建的HarmonyOS应用的“应用包名”一致
Save location	工程文件本地存储路径，由大小写字母、数字和下划线等组成，不能包含中文字符
Compatible SDK	兼容的最低API Version
Module name	模块名称
Device type	该工程模板支持的设备类型，目前仅支持手机设备
Enable CloudDev	是否启用云开发。通用云开发模板默认启用且无法修改

10）步骤十： 为工程关联云开发所需的资源，通俗来说就是将DevEco Studio创建的HarmonyOS应用/元服务与AGC平台创建的应用关联起来。

• 若当前在DevEco Studio未登录账号，点击关联云开发资源界面的“Sign in”，会打开默认浏览器并打开账号登录界面，使用已实名认证的华为开发者账号完成登录。
  
• 账号登录成功后，界面会显示“在DevEco Studio想要访问您的华为账号”授权界面，点击“允许”按钮同意DevEco Studio使用当前账号登录，当然，也可以点击页面中“切换账号”按钮切换其他账号。
  
• 账号登录授权成功后，回到DevEco Studio创建工程向导，关联云开发资源界面会显示账号头像、昵称，同时会显示当前账号下的组织信息，以及根据工程Bundle name在该团队中自动查询AGC平台的同包名应用信息。如果查询到的应用所属项目尚未启用数据处理位置，需要点击界面提示内的“AppGallery Connect”链接设置数据处理位置。
  
• 在浏览器弹出的数据处理位置页签中，点击“管理”按钮，为应用所属项目设置数据处理位置。
  
• 云开发目前仅支持中国站点，因此，必须启用中国站点的数据处理位置，同时设置默认数据处理位置。然后点击“保存”按钮，保存数据处理位置设置。
  
• 返回DevEco Studio创建工程向导关联云开发资源界面，此时，界面中的提示信息消失。点击“Finish”按钮，等待工程初始化完成。DevEco Studio执行创建工程初始化配置时，会为关联云开发资源的项目自动开通云函数、云数据库、云存储等云开发服务，可在DevEco Studio开发工具“Notifications”窗口查看服务开通状态。