创建HarmonyOS应用工程
===============

#### 新建工程

#### \[h2\]前提条件

*   您已完成[开发准备工作](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/agc-harmonyos-clouddev-prerequisite)。
*   您已使用[已实名认证](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/agc-harmonyos-clouddev-account)、且注册地为中国境内（香港特别行政区、澳门特别行政区、中国台湾除外）的华为开发者账号登录DevEco Studio。
*   请确保您的华为开发者账号无欠款，账户欠费将导致云存储服务开通失败。

#### \[h2\]选择模板

1.  选择以下任一种方式，打开工程创建向导界面。
    *   如果当前未打开任何工程，可以在DevEco Studio的欢迎页点击“Create Project”开始创建一个新工程。
    *   如果已经打开了工程，可以在菜单栏选择“File > New > Create Project”来创建一个新工程。
2.  在“Application”页签，选择合适的云开发模板，然后点击“Next”。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/f6/v3/dCHu4QhLTCOc3fNWGijSBA/note_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260612T073824Z&HW-CC-Expire=86400&HW-CC-Sign=831B28C4603BBA014F15F6E84824F42AAA13D3BE3CCB4408007B34C52F55A45D)
    
    当前仅支持通用云开发模板（\[CloudDev\]Empty Ability）。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/28/v3/f0N53kD6RUSQ0e4HM0BEzw/zh-cn_image_0000002462973802.png?HW-CC-KV=V1&HW-CC-Date=20260612T073824Z&HW-CC-Expire=86400&HW-CC-Sign=EBBFE3D570231BAF6FD4FD71F5F4613869FE0B2E879C91848C805B81DC5A6E63)
    

#### \[h2\]配置工程信息

1.  在工程配置界面，配置工程的基本信息。
    
    其中，Device type和Enable CloudDev参数不可更改，其他参数请参考[创建一个新的工程](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-create-new-project#section181328285169)内对应的指导进行配置。
    
    | 
    参数
    
     | 
    
    说明
    
     |
    | :-- | :-- |
    | 
    
    Device type
    
     | 
    
    该工程模板支持的设备类型，目前仅支持手机设备。
    
     |
    | 
    
    Enable CloudDev
    
     | 
    
    是否启用云开发。云开发模板默认启用且无法更改。
    
     |
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/5d/v3/4jzom1xfRTGFJ_WYJVqAKw/zh-cn_image_0000002547465643.png?HW-CC-KV=V1&HW-CC-Date=20260612T073824Z&HW-CC-Expire=86400&HW-CC-Sign=4A82F93E5C368525DBDC34C3D971C439CC096539F1F4FEF6AB9DAFE0C904A634)
    

2.  点击“Next”，开始关联云开发资源。

#### \[h2\]关联云开发资源

为工程关联云开发所需的资源，即将您账号团队在AGC创建的同包名应用关联到当前工程。具体操作如下：

1.  （可选）如您尚未登录DevEco Studio，点击“Sign In”，在弹出的账号登录页面，使用[已实名认证](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/agc-harmonyos-clouddev-account)的华为开发者账号完成登录。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/87/v3/TX5GE-uQSc61NQEGjWyYwg/zh-cn_image_0000002214858793.png?HW-CC-KV=V1&HW-CC-Date=20260612T073824Z&HW-CC-Expire=86400&HW-CC-Sign=A133939FC85F3319809F62C629551DDBD7E796736C6A2D7DBBDC0F0179FACD0D)
    
    登录成功后，界面将展示账号昵称。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/42/v3/qF9WngWnQcS15THuTn1BOg/zh-cn_image_0000002179338404.png?HW-CC-KV=V1&HW-CC-Date=20260612T073824Z&HW-CC-Expire=86400&HW-CC-Sign=18AC4ED67324463AE092DF6D96A88923CE0324B10E51D208A95B085016956F0A)
    
2.  点击“Team”下拉框，选择开发团队。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/71/v3/kz8xR2DEQfSGmnQJROPRrQ/zh-cn_image_0000002500639597.png?HW-CC-KV=V1&HW-CC-Date=20260612T073824Z&HW-CC-Expire=86400&HW-CC-Sign=CB80AFA7C7E35CE1C2AB5E3587EE1B0929B3782C80336BF57634C0203C3BB7E9)
    
3.  关联应用。
    
    选中团队后，系统根据工程Bundle name在该团队中自动查询AGC上的同包名应用。
    
    *   如查询到应用，选中该应用，点击“Finish”即可。
        
        ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/9b/v3/nx7AC13-RTWBFjomyaf5hA/zh-cn_image_0000002214704349.png?HW-CC-KV=V1&HW-CC-Date=20260612T073824Z&HW-CC-Expire=86400&HW-CC-Sign=CB8F371EE1E85FEDDF8D3AE8523512ED879FC1D627ABC3C542CA34E0C9575764)
        
    *   如查询到的应用尚未关联任何项目（即为游离应用），则无法选中。请先[将游离应用添加到AGC项目下](#section152521927193013)。
        
        ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/d0/v3/Wf0kJcBoTM2ajtHrTw6BRg/zh-cn_image_0000002179498144.png?HW-CC-KV=V1&HW-CC-Date=20260612T073824Z&HW-CC-Expire=86400&HW-CC-Sign=AF671062862C4F9688D428639C3476752C4BAFEE4759745887461DB82ECFCCE8)
        
    *   如果查询到的应用所属项目尚未启用数据处理位置，请点击界面提示内的“AppGallery Connect”[设置数据处理位置](https://developer.huawei.com/consumer/cn/doc/app/agc-help-datalocation-0000001160439813)。设置完成后返回DevEco Studio界面，点击Bundle name后的![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/c1/v3/rAPO9HQgSmKHniDffvOoWA/zh-cn_image_0000002495893905.png?HW-CC-KV=V1&HW-CC-Date=20260612T073824Z&HW-CC-Expire=86400&HW-CC-Sign=18E4CBC63E27BF55548918929A57768CB56DDA322E0643DBE158FA7089A90210)刷新当前APP ID列表，即可看到设置的数据处理位置。
        
        ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/33/v3/BBVmZ92CQL2DymSjHBvTkg/caution_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260612T073824Z&HW-CC-Expire=86400&HW-CC-Sign=B1341A0445120FA3E7D5F358EBDF88DD84295D26655ABFA3E37191C476A0B808)
        
        *   由于云开发目前仅支持中国境内（香港特别行政区、澳门特别行政区、中国台湾除外），请确保项目启用的数据处理位置包含“中国”。
        *   无论项目启用的默认数据处理位置为哪个站点，后续开发的云服务资源都将部署在“中国”站点。
        
        ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/5b/v3/3-erzsXSQsGubPdUdwU-KQ/zh-cn_image_0000002495893753.png?HW-CC-KV=V1&HW-CC-Date=20260612T073824Z&HW-CC-Expire=86400&HW-CC-Sign=C2848FEB45C2DC1AD08C6201C5C99B4B3DEC11D34F2BC7E9E73DA0FC1E4C846C)
        
    *   如查询到应用但出现如下提示，表明查询到的应用类型为元服务，与当前工程类型不一致。请修改以确保当前工程与AGC上同包名应用均为HarmonyOS应用类型。
        
        ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/b6/v3/FndCHfiMRKiyts35JRfMMA/zh-cn_image_0000002462815550.png?HW-CC-KV=V1&HW-CC-Date=20260612T073824Z&HW-CC-Expire=86400&HW-CC-Sign=F86EFB73D409A48BD75452A6CB5A4727649E8F8CBAC7B6229E3724852AF261F1)
        
    
    *   如在当前团队中未查询到同包名应用，请先确认填写的包名是否有误。
        
        *   如包名有误，点击界面提示中的“go back”返回工程信息配置界面进行修改。
        *   如包名无误，则表明当前团队尚未在AGC控制台创建与当前工程包名相同的应用。您可点击界面提示中的“AppGallery Connect”，[前往AGC控制台进行补充创建](#section397317130308)。
        
        ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/54/v3/j_k1U1J9SwCGvxBGeuaULg/zh-cn_image_0000002214858765.png?HW-CC-KV=V1&HW-CC-Date=20260612T073824Z&HW-CC-Expire=86400&HW-CC-Sign=74EFA7A0F10675497AE965B9520F86C31C6777659449C0C5D24C4AB090EE2CCB)
        
        完成以上操作后，DevEco Studio即可获取到同包名应用信息。选中应用后，点击“Finish”。
        
        ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/dd/v3/0yAlNCjsSFK_nc-zuR5fMA/zh-cn_image_0000002214858801.png?HW-CC-KV=V1&HW-CC-Date=20260612T073824Z&HW-CC-Expire=86400&HW-CC-Sign=4D9934DB319A4B9848D26D7EE04E82AD216AED23C85F821B1E3ACE113B44F2BC)
        
4.  如您所属的团队尚未签署云开发相关协议，点击协议链接仔细阅读协议内容后，勾选同意协议，点击“Finish”。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/80/v3/PBsXlKjeShW4DEzWN-UdVg/note_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260612T073824Z&HW-CC-Expire=86400&HW-CC-Sign=B3EFCBA9BCC45AF948DA01C4ACEDAF8600B878C3BE9D5B94189DBC1A56899F3A)
    
    只有账号持有者和法务角色才有权限签署协议。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/4d/v3/FVAzUz5yT7WZXLvLHDOReQ/zh-cn_image_0000002179498108.png?HW-CC-KV=V1&HW-CC-Date=20260612T073824Z&HW-CC-Expire=86400&HW-CC-Sign=9B7579BB1F770AEA513F714007F51159A663348942ADEFDB6C597B2EA81E70CD)
    
5.  进入主开发界面，DevEco Studio执行工程同步操作，端侧工程会自动执行“ohpm install”，云侧工程会自动执行“npm install”，以分别下载端侧和云侧依赖。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/bc/v3/-OYYAvM7TIqkTF-xvvg4uw/note_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260612T073824Z&HW-CC-Expire=86400&HW-CC-Sign=5F77715B927733122829B630FE7EEC211F4FAE9E5FFEA3654FA69F769B08A29D)
    
    若云侧执行“npm install”失败，请排查是否尚未[配置NPM代理](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-environment-config#section197296441787)。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/52/v3/EhrYKjEZRVGNpp8qBIemVw/zh-cn_image_0000002179498148.png?HW-CC-KV=V1&HW-CC-Date=20260612T073824Z&HW-CC-Expire=86400&HW-CC-Sign=36F60FF6F635F5DB4003A51ED5A8197488342B4800D6303285E3810BF48EA4A2)
    
6.  在主开发界面，可查看刚刚新建的工程。关于工程的详细目录结构介绍，请参见[端云一体化开发工程目录结构](#section20250910164411)。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/ae/v3/UvUnp-MnTOi9A7RT0RTn0g/zh-cn_image_0000002214704397.png?HW-CC-KV=V1&HW-CC-Date=20260612T073824Z&HW-CC-Expire=86400&HW-CC-Sign=09851A32E0F3E8DEB7ABAAFCFCE110D9700E908A722560D847ADE87238FEA83B)
    

#### 工程初始化配置

当您成功创建工程并关联云开发资源后，DevEco Studio会为您的工程自动执行一些初始化配置。

#### \[h2\]自动开通云开发服务

DevEco Studio为工程关联的项目自动开通云函数、云数据库、云存储等云开发服务，您可在“Notifications”窗口查看服务开通状态。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/ea/v3/dIacdb6LSV2Jfmx_PuSu8w/note_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260612T073824Z&HW-CC-Expire=86400&HW-CC-Sign=6315A1F4EA108C5B0ADA5807C4FEC694E51188B38F831EBF691488EB73B55921)

*   如服务开通失败，您可通过[CloudDev云开发管理面板](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/agc-harmonyos-clouddev-console)快捷进入AGC控制台进行手动开通。
*   如云存储服务自动开通与手动开通均失败，可能是账户欠费导致。请您[检查账户是否余额不足](https://developer.huawei.com/consumer/cn/doc/AppGallery-connect-Guides/agc-account-bill-0000001200817917#section813072912208)，[补齐欠款](https://developer.huawei.com/consumer/cn/doc/AppGallery-connect-Guides/agc-account-recharge-0000001126625360)后再前往AGC控制台进行手动开通。

#### 端云一体化开发工程目录结构

端云一体化开发工程主要包含端开发工程（Application）与云开发工程（CloudProgram）。

#### \[h2\]端开发工程（Application）

端开发工程主要用于开发应用端侧的业务代码，使用通用云开发模板创建的端开发工程目录结构如下图所示。“Application/cloud\_objects”模块用于存放云对象的端侧调用接口类，“src/main/ets/pages”目录下包含了云存储、云数据库和云函数页面，其他目录文件介绍请参见[工程目录结构](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-project-structure)。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/a7/v3/kO7zaZraQx6OGnRv2uks_A/zh-cn_image_0000002214858825.png?HW-CC-KV=V1&HW-CC-Date=20260612T073824Z&HW-CC-Expire=86400&HW-CC-Sign=06BE5F415B9CF49F96CF0B325DB457D8ABA46D97B6A3275DA2D8522568135AD9)

#### \[h2\]云开发工程（CloudProgram）

在云开发工程中，您可为您的应用开发云端代码，包括云函数和云数据库服务代码。使用通用云开发模板创建的云开发工程目录结构如下图所示。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/66/v3/uOp7s05gRUKqDqL4sWuQog/zh-cn_image_0000002279845320.png?HW-CC-KV=V1&HW-CC-Date=20260612T073824Z&HW-CC-Expire=86400&HW-CC-Sign=3093AD06A00AD4C9F4E7A4A06ED46450D438FFB1CE29841C36EEA9C6785D900C)

*   clouddb：云数据库目录，包含数据条目目录（dataentry）和对象类型目录（objecttype）。
    *   dataentry：用于存放数据条目文件。
        
        该目录下一般会根据您选择的云开发模板预置数据条目示例文件。在通用云开发模板工程中，该目录下会预置名为“d\_Post.json”的数据条目示例文件，内含两条示例数据。您可按需使用、修改或删除。
        
        ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/3/v3/DvxqS9D_RvCng-UMO3q-GQ/zh-cn_image_0000002314788585.png?HW-CC-KV=V1&HW-CC-Date=20260612T073824Z&HW-CC-Expire=86400&HW-CC-Sign=F2C9AAB62427BFADB15AD2D44502B3D0FCCAF9FE64CE4C29C96CDEC951AF41B5)
        
    *   objecttype：用于存放对象类型文件。
        
        该目录下一般会根据您选择的云开发模板预置对象类型示例文件。在通用云开发模板工程中，该目录下会预置名为“Post.json”的对象类型示例文件，内含对象类型“Post”的权限、索引、字段名称和字段值等。您可按需使用、修改或删除。
        
        ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/c2/v3/gecsr-ZnQOqUD7dYkFqz0g/zh-cn_image_0000002179498164.png?HW-CC-KV=V1&HW-CC-Date=20260612T073824Z&HW-CC-Expire=86400&HW-CC-Sign=A674A6EF0FD661FD98A3DC68394D13C130B31B457E228C05772AAC230B2A7086)
        
    *   db-config.json：模块配置文件，主要包含云数据库工程的配置信息，如默认存储区名称、默认数据处理位置。
*   cloudfunctions：云函数目录，包含各个云函数/云对象子目录。每个子目录下包含了云函数/云对象的配置文件、入口文件、依赖文件等。
    
    该目录下一般会根据您选择的云开发模板预置示例函数。通用云开发模板工程下预置了一个用于生成UUID的示例云对象“id-generator”，您可按需使用、修改或删除。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/96/v3/3Hz0LhSCRZCXLVY20fT8lQ/zh-cn_image_0000002179498100.png?HW-CC-KV=V1&HW-CC-Date=20260612T073824Z&HW-CC-Expire=86400&HW-CC-Sign=EE72817E4D826414B495FB335E7B3C5228FA3DC91DEFF61A45F144B4CAB40294)
    
*   node\_modules：工程同步时执行“npm install”生成，包含“typescript”和“@types/node”公共依赖。
*   cloud-config.json：云开发工程配置文件，包含应用名称与ID、项目名称与ID、启用的数据处理位置、支持的设备类型等。
*   package.json：定义了“typescript”和“@types/node”公共依赖。
*   package-lock.json：工程同步时执行“npm install”生成，记录当前状态下实际安装的各个npm package的具体来源和版本号。

#### （可选）AGC应用管理

#### \[h2\]从DevEco Studio补充创建同包名应用

如创建工程时，发现尚未在AGC控制台创建与工程包名相同的应用，可进行补充创建。

1.  点击界面提示内的“AppGallery Connect”，浏览器打开AGC控制台页面。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/0c/v3/J4eNqh4hQ6qEoB4gHodChQ/zh-cn_image_0000002214858733.png?HW-CC-KV=V1&HW-CC-Date=20260612T073824Z&HW-CC-Expire=86400&HW-CC-Sign=355B413A0D275185F11F36FE317D5EBA904C466F8A3EC7E952FDF3323B4D3A82)
    
2.  在“应用开发基础信息”页面，填写待创建的应用信息，完成后点击“下一步”。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/93/v3/3LFx5fbbTdaTe36XmxHW-w/zh-cn_image_0000002312627449.png?HW-CC-KV=V1&HW-CC-Date=20260612T073824Z&HW-CC-Expire=86400&HW-CC-Sign=0D2D0BF2FD48B6C5461D0DEEAA36722C41F5AE02BA21141980A6516538FE6337)
    
    | 
    参数
    
     | 
    
    说明
    
     |
    | :-- | :-- |
    | 
    
    应用类型
    
     | 
    
    创建的HarmonyOS应用形态，默认与您本地工程类型保持一致，不可更改。
    
     |
    | 
    
    应用名称
    
     | 
    
    应用在华为应用市场详情页展示的名称。
    
     |
    | 
    
    应用包名
    
     | 
    
    从DevEco Studio中带入自动填充，且不可更改。
    
     |
    | 
    
    应用分类
    
     | 
    
    请选择普通应用或游戏类应用。
    
    说明：
    
    应用分类设置后不支持修改，请谨慎选择。
    
    
    
    
    
     |
    
3.  进入“所属项目信息”页面，为应用选择所属的项目后点击“下一步”。
    
    *   如需将应用添加到已有项目，点击下拉框进行选择。
    *   如需将应用添加到新项目，直接在框中填写新项目名称。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/81/v3/KrbTP35ySwOuJ9b9LHhq5A/zh-cn_image_0000002312628981.png?HW-CC-KV=V1&HW-CC-Date=20260612T073824Z&HW-CC-Expire=86400&HW-CC-Sign=910BDEF545763FBFBB615F000025854EBCB6125895836E55950A7C1DA4408F00)
    
4.  进入“云开发数据处理位置”页面，设置或管理项目的数据处理位置。
    *   如项目尚未设置数据处理位置：
        1.  点击“启用”。
            
            ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/d6/v3/QA5VJ4quQdGfOEGOnTBvzg/zh-cn_image_0000002312516673.png?HW-CC-KV=V1&HW-CC-Date=20260612T073824Z&HW-CC-Expire=86400&HW-CC-Sign=1A441F08AEC458784B3924FE29485E1895B41C7685D6A3FA41295587B505ED7B)
            
        2.  仔细阅读提示框的文字说明后，在“启用”栏为您的项目勾选一个或多个数据处理位置，并在“设为默认”栏将其中一个设置为默认数据处理位置。
            
            ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/66/v3/KQ4mPOnYTmagH2DrbH4jGQ/caution_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260612T073824Z&HW-CC-Expire=86400&HW-CC-Sign=F685989DB5A8580B458E4E8C32C7B0BC4A30E1A0331803255FDF9145238BB697)
            
            启用的数据处理位置必须包含中国站点。
            
            ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/17/v3/_LrhejjAQv-_8ofD7wt2cQ/zh-cn_image_0000002214858805.png?HW-CC-KV=V1&HW-CC-Date=20260612T073824Z&HW-CC-Expire=86400&HW-CC-Sign=CFCE881CE93938388F45EFD2E9FB15EBA3F10D8EFA72F4D3682BF6A14BCCE0BE)
            
    *   如项目已设置过数据处理位置，可点击“管理”启用新的数据处理位置、取消已启用的数据处理位置，或修改默认数据处理位置。
        
        ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/ab/v3/oS_ChlzrRPm8oddeSqTohw/zh-cn_image_0000002312630869.png?HW-CC-KV=V1&HW-CC-Date=20260612T073824Z&HW-CC-Expire=86400&HW-CC-Sign=45FDCCDEE17BCD5E0BDA132CA2D32D3327B948260352189F7EE2E34DB7D15CAF)
        
5.  点击“确认”，应用创建完成。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/98/v3/838hLpYISda0hLm04vU5wg/zh-cn_image_0000002214858821.png?HW-CC-KV=V1&HW-CC-Date=20260612T073824Z&HW-CC-Expire=86400&HW-CC-Sign=3C5D801D9F89DA40917E58EC76E49F59F3BE1094B40A51592B34A0344E2D4048)
    
6.  返回DevEco Studio，可看到界面已获取并展示了刚刚创建的应用信息。若不展示，可点击Bundle name后的![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/c0/v3/KCYTzJ-lRfGv3qBQ_yM-Cw/zh-cn_image_0000002500745449.png?HW-CC-KV=V1&HW-CC-Date=20260612T073824Z&HW-CC-Expire=86400&HW-CC-Sign=B94187FD81B2FA608E93F798CCC5F40AC1BF3430347F3FEF89C15DCAC59706CF)刷新。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/18/v3/yyOMsTQDSK6x9MbjufdOmA/zh-cn_image_0000002179338492.png?HW-CC-KV=V1&HW-CC-Date=20260612T073824Z&HW-CC-Expire=86400&HW-CC-Sign=E94E2D100AFF73481A6555722120BA4F5EF431CD39F86A0969D0A90FA7BA6052)
    

#### \[h2\]将游离应用添加到AGC项目下

游离应用指未关联任何AGC项目的应用。创建工程时，如需要关联的AGC应用为游离应用，则您需要将该应用添加到您的AGC项目下。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/fa/v3/18h5KRbHTFq3WllfnF2TKg/caution_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260612T073824Z&HW-CC-Expire=86400&HW-CC-Sign=BBA73D535C4AF587055A1B0D6A6EF7D4F136EDA40001C5BF5BBEFF6725F063C9)

应用与项目的关联关系一旦创建则无法再修改，请谨慎操作。

1.  点击“Not associated yet”，或点击界面下方提示内的“AppGallery Connect”，可打开AGC控制台“开发与服务”页面。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/73/v3/c8RqWniNTzyj9tUOEirfhg/zh-cn_image_0000002214704437.png?HW-CC-KV=V1&HW-CC-Date=20260612T073824Z&HW-CC-Expire=86400&HW-CC-Sign=E70065F7D063B4951E1558939584E62B2762922554C18243B670D8EFA084CACE)
    
2.  点击选择希望为应用关联的项目，或者点击“添加项目”新建一个项目。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/9e/v3/tYtMNLmPTnSbp-VYZ0tpmQ/zh-cn_image_0000002496495517.png?HW-CC-KV=V1&HW-CC-Date=20260612T073824Z&HW-CC-Expire=86400&HW-CC-Sign=0086C87DAA62E8031AA0763FED81475C16245C5CD8B170C2B854F9E7506B7C33)
    
3.  如选择了新建一个项目，设置项目名称，点击“确认”。
    
    如选择了已有项目，则忽略此步骤。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/a4/v3/B_wk64SzTSO_sUB2tpyr9Q/zh-cn_image_0000002214704389.png?HW-CC-KV=V1&HW-CC-Date=20260612T073824Z&HW-CC-Expire=86400&HW-CC-Sign=9536D5A53CBF302B25563B5675DC64A36904A67AB51C450C9EC86DAAD7A96326)
    
4.  设置或管理项目的数据处理位置。
    *   如项目尚未设置数据处理位置：
        1.  点击“启用”。
            
            ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/9e/v3/INto2TkNQIyMu8hhqORVIQ/zh-cn_image_0000002214704417.png?HW-CC-KV=V1&HW-CC-Date=20260612T073824Z&HW-CC-Expire=86400&HW-CC-Sign=2BA15226B07FBF13F2217A05367ED9CF9845095D8D916BBF1508125E98156860)
            
        2.  仔细阅读提示框的文字说明后，在“启用”栏为您的项目勾选一个或多个数据处理位置，并在“设为默认”栏将其中一个设置为默认数据处理位置。
            
            ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/6c/v3/aiNs_H9BQs6ywqJldgX6FQ/caution_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260612T073824Z&HW-CC-Expire=86400&HW-CC-Sign=8C3F3F62D290E78372F39B29177A320ADC4AAFB6D82126AFA66F8845DC477FE1)
            
            启用的数据处理位置必须包含中国站点。
            
            ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/bc/v3/p3bUxXvYQCqX_ZUJ0g9Q6A/zh-cn_image_0000002179338436.png?HW-CC-KV=V1&HW-CC-Date=20260612T073824Z&HW-CC-Expire=86400&HW-CC-Sign=D2180CCE393A08E149B2969CF12325F1FB3B4278A14A8EA4B1CE172DDE2B5967)
            
    *   如项目已设置过数据处理位置，可点击“管理”启用新的数据处理位置、取消已启用的数据处理位置，或修改默认数据处理位置。
        
        ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/60/v3/45XORwOXRyuO6J1vFVzVsg/zh-cn_image_0000002179338464.png?HW-CC-KV=V1&HW-CC-Date=20260612T073824Z&HW-CC-Expire=86400&HW-CC-Sign=FD6D9600B7C3DE5AB04563A81E348C59312A053275C102BC157E2E9DA5A4FDD1)
        
5.  点击“确认”，应用成功关联项目。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/77/v3/GWKneOsyRg-OGKJ34LkC7w/zh-cn_image_0000002179498200.png?HW-CC-KV=V1&HW-CC-Date=20260612T073824Z&HW-CC-Expire=86400&HW-CC-Sign=60010E93277DFDDDC1F12FE6DF903E68750E512E7ECA14A3D022F61CB6AE1111)
    
6.  返回DevEco Studio，可看到应用已关联上了项目。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/bd/v3/q8R_Ql3YTTKh_E3mAOZ_9Q/zh-cn_image_0000002214858777.png?HW-CC-KV=V1&HW-CC-Date=20260612T073824Z&HW-CC-Expire=86400&HW-CC-Sign=39BA19BF90EB9AD9B040D12F0EBB56A533241EDA198DB2F417DF5E43F8E38D81)