开发准备
====

#### 创建游戏

若在华为应用市场发布游戏，或使用AGC控制台提供的服务，需要前往AGC控制台创建游戏类应用，具体操作请参见[创建项目](https://developer.huawei.com/consumer/cn/doc/app/agc-help-create-project-0000002242804048)和[创建HarmonyOS应用](https://developer.huawei.com/consumer/cn/doc/app/agc-help-create-app-0000002247955506)。其中：

*   “应用类型”：选择“HarmonyOS应用”。
    
*   “应用分类”：选择“游戏”。
    

#### 申请近场快传开放能力

基于安全考虑，系统侧对近场快传功能做了权限保护处理，使用相关接口开发者需先提交“近场快传”能力开关的申请，在申请通过后，再使用该能力开关。

1.  登录[AppGallery Connect](https://developer.huawei.com/consumer/cn/service/josp/agc/index.html#/)，点击“开发与服务”。在项目列表中找到项目，并点击选择需要申请权限的游戏。
    
2.  在“项目设置”页面，选择“开放能力管理”页签，开始为游戏申请近场快传开放能力。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/4a/v3/MgeyyTlzQOihp3Ei6C-EgQ/zh-cn_image_0000002594829122.png?HW-CC-KV=V1&HW-CC-Date=20260612T073609Z&HW-CC-Expire=86400&HW-CC-Sign=D219E9BAC9E76A6246C7E7B4718E0AF42934071E15C310163387CCA3FEC74CBE)
    
3.  搜索“近场快传”，点击对应能力后面的“申请”，打开“新建业务申请”窗口。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/b2/v3/FlfSz1ZySfGGA_VWfwpkLw/zh-cn_image_0000002625188569.png?HW-CC-KV=V1&HW-CC-Date=20260612T073609Z&HW-CC-Expire=86400&HW-CC-Sign=9B81EFBA3D2D353F2C889787748C8B774531378CE436FEAE0C6208C800F80F29)
    
4.  在“新建业务申请”窗口填写申请信息，然后点击“提交”。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/db/v3/lcEydaFsRzOugTBye0cs8Q/zh-cn_image_0000002625108713.png?HW-CC-KV=V1&HW-CC-Date=20260612T073609Z&HW-CC-Expire=86400&HW-CC-Sign=40CB092B3178C176F197C4EEFE737558710B5D52F09D4AC456A43CE791BD4038)
    
    | 配置项 | 必填/选填 | 说明 |
    | :-- | :-- | :-- |
    | 申请原因 | 必填 | 申请近场快传的原因，请按照模板填写相关信息，字数不超过512个字符。 |
    | 上传附件 | 选填 | 仅可上传1个附件，大小不超过500MB。支持文本、表格、图片、视频、压缩包格式。 |
    
5.  进入互动中心页面，可以看到申请已提交的消息。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/82/v3/l-Bqchs6S9CU8j-K9rDgKQ/zh-cn_image_0000002594669196.png?HW-CC-KV=V1&HW-CC-Date=20260612T073609Z&HW-CC-Expire=86400&HW-CC-Sign=428BFE8E6D2987E9C623C2E91FE9C471AC48FC616BA5058D3CBD504626176F52)
    
    返回“开放能力管理”页面，近场快传显示“申请中”，1-3个工作日反馈申请结果。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/28/v3/_mP6RKBUQf2AeSzXKQU3-A/zh-cn_image_0000002594829124.png?HW-CC-KV=V1&HW-CC-Date=20260612T073609Z&HW-CC-Expire=86400&HW-CC-Sign=700EF099200C118779E382725A6B5D50150300E3736EF5978628817F06D49451)
    
6.  申请审批通过后，互动中心将会发送通知给您，同时近场快传的能力开关会为您自动开启，“申请中”也会变为置灰显示的“申请”。至此，游戏已成功开启近场快传开放能力。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/b2/v3/A36BKCxwSJaU3sjkIgJgKA/zh-cn_image_0000002625188571.png?HW-CC-KV=V1&HW-CC-Date=20260612T073609Z&HW-CC-Expire=86400&HW-CC-Sign=F527607B0D592E90BDAE6AE7D15EA9C826EE422386104AEDB00D6AB75B778516)
    

#### 生成签名证书

数字证书和Profile文件等签名信息可以确保游戏的完整性，请参见[配置签名信息](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/application-dev-overview#配置签名信息)完成配置。

#### 配置APP ID和相关权限

1.  登录[AppGallery Connect](https://developer.huawei.com/consumer/cn/service/josp/agc/index.html)平台，在“开发与服务”中选择目标应用，获取“项目设置 > 常规 > 应用”的**APP ID**。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/53/v3/FIv_iG9XSSGiM70Elnsspw/zh-cn_image_0000002625108715.png?HW-CC-KV=V1&HW-CC-Date=20260612T073609Z&HW-CC-Expire=86400&HW-CC-Sign=221B01D5E23F1858884492C4DE4CD602153EF430E546A6C08AEA8AD5BD3513FB)
    
2.  在工程的entry模块module.json5文件中，新增metadata并配置app\_id，同时新增requestPermissions并配置如下权限。
    
    "module": {
      "name": "entry",
      "type": "entry",
      "description": "xxxx",
      "mainElement": "xxxx",
      "deviceTypes": \[
        "phone"
      \],
      "deliveryWithInstall": true,
      "pages": "$profile:main\_pages",
      "abilities": \[\],
      "metadata": \[ // 配置如下信息
        {
          "name": "app\_id",
          "value": "xxxxxx" // 配置为前面步骤中获取的APP ID
        }
      \],
       "requestPermissions": \[ // 配置权限
         {
           "name": "ohos.permission.INTERNET" // 允许使用Internet网络权限
         },
         {
           "name": "ohos.permission.GET\_NETWORK\_INFO"  // 允许应用获取数据网络信息权限
         },
         {
           "name": "ohos.permission.SET\_NETWORK\_INFO" // 允许应用配置数据网络权限
         },
         {
           "name": "ohos.permission.DISTRIBUTED\_DATASYNC", // 允许不同设备间的数据交换权限
           "reason": "$string:distributed\_permission",
           "usedScene": {
             "abilities": \[
               "EntryAbility"
             \],
             "when": "inuse"
           }
         }
       \]
    }