前言 #

目前独立版APP编译对于开发工作量较大,请谨慎而行,避免多次打包。谢谢合作。资料较多,请按要求填写到后台。

DCloud #

1 打开DCloud开发者中心 (opens new window) 并登录账号,若无账号请自行注册并通过企业实名认证 (opens new window) #

5127be46ee0489f55f588e0a3b62aa7c

温馨提示

此位置切记一定需要进行实名认证 以及 手机号验证!!

2 创建应用 选择 uni-app 即可获得UNI ID #

3 点击应用名称即可管理应用 #

包名 pkgName / Bundle ID #

温馨提示

一定要保证在各个地方填写的包名一致,一个APP只有一个包名,唯一且不互相干扰重复~ 包名按.分为三段,包名只能含有下划线、字母、数字,每一段都需要以英文字母开头且不可以数字开头,包名首字母需小写

包名一般做法是将自己的域名进行倒置 例如:我们域名是boolc.cn,对应三个端的包名就应该为cn.boolc.对应端标识

  • 用户端app包名为:cn.boolc.user
  • 商户端app包名为:cn.boolc.merchant
  • 配送端app包名为:cn.boolc.delivery

签名与证书 #

Android SHA1和SHA256 #

在咱们后台APP基础设置中,有一个自动生成签名的按钮,将对应信息填完整后生成签名,点击此按钮就会获得证书、签名信息,找到其中的SHA1和SHA256便是我们需要的,对应对接平台需要什么就复制什么填写到对应位置。

Android MD5 #

将后台生成的证书文件上传 香蕉云编 (opens new window) 获取签名

iOS的描述文件与证书 #

如果还没有苹果开发者账号,自行注册苹果开发者中心 (opens new window) #

证书配置 证书教程 (opens new window) Win系统请使用 香蕉云编 (opens new window) / appuploader (opens new window) 进行生成。 #

1 发布证书(三个端只需一个即可 格式.p12 上传到后台 私钥证书#

2 P8证书(三个端只需一个即可 格式.p8 上传到 DCloud UniPush) #

3 描述文件(每个端一个 格式.mobileprovision 上传到后台 描述文件#

由于篇幅有限,iOS另起一页,详见 香蕉云编 / appuploader #

推荐使用正方形,仅支持.png格式,请自行设置,建议1024*1024px,iOS上架应用市场必须大于1024px,且iOS上架图片不允许带有透明通道

APP启动页 #

Android #

有两种启动图选择方式:

  • [推荐] .9.png可以减少包体积、避免缩略图影响清晰度,查看教程 (opens new window)
  • png格式图片文件,尺寸推荐竖屏1882*1080px,大小控制在1m以内

IOS #

有两种启动图选择方式:

高德地图 #

每个端都是单独的设置,请仔细检查,否则会出现定位失败的情况。

选择对应平台 安卓/iOS用户/商户/配送 每个端都需要单独设置,总共6个key。

微信开放平台(商户/配送可选) #

温馨提示

需要支付、分享、跳转小程序、跳转微信客服等开放能力才需要,即用户端需要弄,商户端/配送端自行视情况选择是否处理。

1 打开微信开放平台 (opens new window) 并登录账号,若无账号请自行注册并通过企业实名认证 #

2 创建移动应用并填写相关信息,应用签名可以认证通过后修改,详见第3步 #

3 Android应用签名 MD5 #

  • 此链接统一为 移动端域名/.well-known/ 例如 https://app.boolc.cn/.well-known/
  • 在网站根目录下的.well-known文件夹(如没有请新建此文件夹)内新建文件apple-app-site-association写入内容:
{
	"applinks": {
		"apps": [],
		"details": [
			{
				"appID": "苹果开发者Team ID.用户端BundleID",
				"paths": ["*"]
			},
			{
				"appID": "苹果开发者Team ID.商户端BundleID",
				"paths": ["*"]
			},
			{
				"appID": "苹果开发者Team ID.配送端BundleID",
				"paths": ["*"]
			}
		]
	}
}

示例如下:

{
	"applinks": {
		"apps": [],
		"details": [
			{
				"appID": "B88888888.cn.boolc.user",
				"paths": ["*"]
			},
			{
				"appID": "B88888888.cn.boolc.merchant",
				"paths": ["*"]
			},
			{
				"appID": "B88888888.cn.boolc.delivery",
				"paths": ["*"]
			}
		]
	}
}
  • 保存文件后 用浏览器打开移动端域名/.well-known/apple-app-site-association测试是否能正常访问

苹果开发者Team ID获取 img

PUSH #

1 打开DCloud开发者中心 (opens new window) 并登录账号 #

2 创建/打开应用 #

image-20220822181057793

3 设置推送 UniPush 1.0 #

image-20220822181246552

image-20220822181354224

image-20220822181525018

4 Android厂家推送 (opens new window) 点击跳转查看详细指引 #

image-20220822181127348

对于机型的适配 设置以下内容后效果更好 #

  • 华为:需要先向华为侧发邮件申请权限参见 华为消息分类申请 (opens new window)
  • 小米:小米推送的消息通道分为“普通消息”(默认)和“重要消息”两类,默认下发普通消息。普通消息单日可推送数量有限制,重要消息不限。重要消息申请具体请参考: 小米推送消息分类新规 (opens new window)
  • OPPO:需要联系客服开通;OPush平台上所有通道分为“公信”(默认)、“私信”两类,默认下发公信消息。公信消息单日可推送数量有限制,私信消息不限(仅限单个用户)。私信消息申请请参见(OPPO官方文档)通道升级公测邀请 (opens new window)
  • vivo:消息分类功能将推送消息类型分为运营消息和系统消息,默认下发运营消息。运营消息单用户单应用单日接收条数上限为5条,系统消息不限。系统消息功能不用申请,可以直接使用,如特殊情况需额外提升系统消息量级,请参见(vivo官方文档)推送消息分类功能说明 (opens new window)

通道 Channel #

商户端 #
通道名称 默认 通道ID 小米 通道ID 自定义铃声 URL 自定义铃声 文件名
新订单通知 order high_custom_1 android.resource://商户端APP包名/raw/order order
系统自动接单通知 accept high_custom_2 android.resource://商户端APP包名/raw/accept accept
退单通知 refund high_custom_3 android.resource://商户端APP包名/raw/refund refund
催单通知 reminder high_custom_4 android.resource://商户端APP包名/raw/reminder reminder
配送端 #
通道名称 默认 通道ID 小米 通道ID 自定义铃声 URL 自定义铃声 文件名
新订单通知 order high_custom_1 android.resource://配送端APP包名/raw/order order
抢单通知 grab high_custom_2 android.resource://配送端APP包名/raw/grab grab
退单通知 refund high_custom_3 android.resource://配送端APP包名/raw/refund refund
催单通知 reminder high_custom_4 android.resource://配送端APP包名/raw/reminder reminder
上次更新: 11/5/2023, 7:00:31 PM