DCloud appid 用途/作用/使用说明

DCloud appid（以后简称 appid） 是 DCloud 应用的唯一标识，在 DCloud 提供的所有服务中，都会以 appid 来标记一个应用。注意这和各家小程序的appid以及Apple的appid（其实就是iOS的包名）是两套体系。

本文将介绍DCloud appid 的各种使用场景。

管理 appid

创建应用

• 在 HBuilderX 中创建项目时，HBuilderX 会自动联网生成 appid, 并将该 appid 保存在 manifest 文件中的 appid 字段；
• 登录开发者中心，也可以创建 uniapp、5+app 等类型应用的 appid；
• wap2app 项目比较特殊，wap2app 项目的 appid 是在 HBuilderX 中本地生成的，需要提交云打包后，appid 才会同步到服务端；如果在开发者中心的应用列表中查找不到 wap2app 项目的 appid，提交一次云打包即可。

注意：以下场景不会自动生成 appid，开发者可以登录开发者中心自行创建。

• 使用离线打包
• 使用 cli 创建 uniapp 项目

创建者即为该应用的所有者。一个应用只能有一个所有者，但可以设置多个协作者。

查看应用列表

登录 开发者中心 可以查看自己创建的应用列表。

其它相关操作

• 如何授权应用（设置协作者）
• 如何转让应用
• 认领 wap2app appid：如果开发者发现自己创建 wap2app 项目 appid 被其他人占用时，可以登录开发者中心，点击“wap2app应用认领”完成自助认领。认领前请先确认是否是由同事或其他认识的人所创建，如由同事创建也可通过转让应用的方式将 appid 转移到对应账号下。

使用场景

1. 云打包

   • DCloud 根据 appid 来判断用户是否有权限进行云打包。既不是所有者、又不是协作者，就无法打包；
   • 打包后的原生应用根据 appid 来管理本地资源。每个appid有独立的沙盒，存储是隔离的；
   • 热更新（wgt升级）通过 appid 来覆盖资源

2. 数据统计

3. 广告

4. 换量

5. uni push

6. 制作发行页面

7. 原生应用崩溃日志

8. 用户反馈

9. 购买原生插件

提示：上述内容除云打包外，均通过 开发者中心 查看。

修改 appid 可能引发的问题

• 使用新 appid 打包的应用在更新时，会丢失本地缓存的数据，包括plus.storage（uni.setStorage）保存的数据、plus.io保存的文件等
• 无法使用新的 appid 进行 wgt 升级
• 开发者中心提供的相关云服务会出现多个应用，如统计数据、广告、换量、崩溃日志、用户反馈数据等。
• 如果开通 uni push ，在发布推送消息时，需要考虑多个 appid 的情况。
• 如果在插件市场购买过原生插件，修改 appid 后无法继续使用，需要重新购买。