DCloud appid(以后简称 appid) 是 DCloud 应用的唯一标识,在 DCloud 提供的所有服务中,都会以 appid 来标记一个应用。注意这和各家小程序的appid以及Apple的appid(其实就是iOS的包名)是不同的体系。
管理 appid
创建应用
- 在 HBuilderX 中创建项目时,HBuilderX 会自动联网生成 appid, 并将该 appid 保存在 manifest 文件中的
appid
字段; - 登录开发者中心,也可以创建 uniapp、5+app 等类型应用的 appid;
- wap2app 项目比较特殊,wap2app 项目的 appid 是在 HBuilderX 中本地生成的,需要提交云打包后,appid 才会同步到服务端;如果在开发者中心的应用列表中查找不到 wap2app 项目的 appid,提交一次云打包即可。
- 认领 wap2app appid:如果开发者发现自己创建 wap2app 项目 appid 被其他人占用时,可以登录开发者中心,点击“wap2app应用认领”完成自助认领。认领前请先确认是否是由同事或其他认识的人所创建,如由同事创建也可通过转让应用的方式将 appid 转移到对应账号下。
注意:以下场景不会自动生成 appid,开发者可以登录开发者中心自行创建。
- 使用离线打包
- 使用 cli 创建 uniapp 项目
创建者即为该应用的所有者。一个应用只能有一个所有者,但可以设置多个协作者。
使用场景
- 云打包
- DCloud 根据 appid 来判断用户是否有权限进行云打包。既不是所有者、又不是协作者,就无法打包;
- 打包后的原生应用根据 appid 来管理本地资源。每个appid有独立的沙盒,存储是隔离的;
- 热更新(wgt升级)通过 appid 来覆盖资源
- 数据统计
- 广告
- 换量
- uni push
- 制作发行页面
- 用户反馈
- 购买原生插件
- uni云端一体安全网络
查看 appid
1、在 HBuilderX 中,找到对应项目下的 manifest.json 文件
2、在uniapp开发者后台,应用列表中找到对应项目
修改 appid
- 在 HBuilderX 打开 manifest.json,在“基础配置”界面点击“重新获取”,可以生成新的 appid。注意:项目名称不变时,不会分配新的 appid。
- 通过 manifest.json 源码视图修改 appid,适用于需要将 appid 修改回历史 appid 的场景。
修改 appid 将会引发的问题
- 使用新 appid 打包的应用在更新时,会丢失老版应用本地缓存的数据,包括plus.storage、uni.setStorage保存的数据、plus.io保存的文件、plus.sqlite的数据等
- 无法使用新的 appid 进行 wgt 升级
- 开发者中心提供的相关云服务会出现多个应用,如统计数据、广告、换量、崩溃日志、用户反馈数据等。
- uni push需要重新配置,否则无法推送
- 如果在插件市场购买过原生插件,这些插件会绑定appid。修改 appid 后无法继续使用插件,需要重新购买。
- 已开通uniad增强广告的应用,修改 appid 后会导致广告无法正常展示。
- uni云端一体安全网络将无法使用