# 5-1 配送员APP
# 配送端APP新版需要准备的资料
**配送员app打包及需要提供的资料（购买配送员app的客户必看）**
**1、提供授权站点url或授权域名**
**2、提供app的应用名称**
**3、打包公众号uniacid**
**4、提供应用logo**（png格式）,图片命名用 尺寸命名。例如：某个图片的尺寸是40\*40， 则文件名为：40.png
180\*180，512\*512, 1024\*1024 (ps:一个也不能少)
**5、提供应用启动页图片**（png格式）,图片命名用 尺寸命名。例如：某个图片的尺寸是1080\*1920， 则文件名为：1080.1920.png
1080\*1920, 1125\*2436(ps:一个也不能少)
**6、包名**
**自定义包名**，安卓APP申请极光推送和高德地图都会使用到该包名，包名命名规则：com.应用名称.delivery，例如：应用名称为：啦啦外卖配送员，包名则为com.lalawaimaipeisong.delivery
**7、**申请极光推送账号，（该账号用于在app进行订单推送通知），申请成功后需要将AppKey和Master Secret写到申请资料里面， 提供给外送团队官方。****
**具体申请步骤如下：**
(1) 首先注册极光账号，已有账号的直接登陆即可。登陆地址：[https://www.jiguang.cn/accounts/login/form](https://www.jiguang.cn/accounts/login/form)
(2) 进入管理控制台，点击创建新应用，应用名称自己设置。如下图：
(3) 应用创建完成以后，**将AppKey和Master Secret写到申请资料里面**，如下图：
(4)设置应用信息， 这里需要特别注意， 应用包名为上述第6步自己定义的包名， IOS部分的设置暂时先不用设置，
(5) **申请成功后需要将AppKey和Master Secret复制到后台**。请注意， 不要发别人的appkey， 否则会造成订单推送错误的问题。配送员app的版本号请勿随意更改,**目前安卓版本和苹果的版本号都是1.0**， 序列号暂时不用填写，打包完成以后开发者会统一告诉大家。
**8.申请高德地图key值，**申请成功后需要将Key值写到申请资料里面， 提供给外送团队官方。****
**具体申请步骤如下：**
（1）首先注册高德地图开放平台账号，已有账号的直接登陆即可。登陆地址：[http://lbs.amap.com/](http://lbs.amap.com/)
（2）右上角进入控制台，点击创建新应用，这里应用名称和类型自己设置，如下图：
完了以后点击创建。
（3）点击添加新key，设置应用信息，如下图：
key名称自己写，例如：配送员APP--安卓端；
服务平台选择Android平台；
发布版安全码：写固定值：10:49:D8:DD:46:78:44:77:8D:C6:1D:3B:75:45:B0:1B:8F:AE:81:76；
packgename：自定义包名，填写上述第6步自己定义的包名。
配置完成之后，将key填写进txt资料里。
（4）点击添加新key，设置应用信息，如下图：
key名称自己设置，例如：配送员--iOS版；
服务平台选择iOS平台；
安全码BundleID填写上述第6步自定义的包名；
配置完成之后，将key填写进txt资料里。
**至此，配送员APP安卓需要申请的资料到此结束，有问题联系我们的客服咨询哦。**
# 5-2-1 所需申请各种权限
* 1、短信功能 （必须）
外卖wap版本将加入短信注册提醒等功能，请提现做好短信接口的申请。
* 2、appstore开发者账号（可选）
如果您需要上架appstore，需要申请苹果开发者账户，审核周期约在14天左右
申请教程：[http://blog.csdn.net/wqt925497045/article/details/51583699](http://blog.csdn.net/wqt925497045/article/details/51583699)
备注：打包版APP需要自行上架，官方不提供上架服务
* 3、微信授权登录（可选）
微信授权登录为APP内一键唤起微信APP进行授权登录，申请便捷简易，建议申请
申请地址：[http://open.weixin.qq.com](http://open.weixin.qq.com/)
* 4、QQ登录（可选）
QQ登录同理于微信登录
申请地址：[http://op.open.qq.com](http://op.open.qq.com/)
备注：安卓版QQ登录需要在应用宝上架才可使用
* 5、微信支付（可选）
此处微信支付为APP内支付唤起微信APP进行支付，申请便捷建议，建议申请
申请地址： [http://open.weixin.qq.com](http://open.weixin.qq.com/)
* 6、支付宝支付（可选）
需要申请企业支付宝APP支付接口申请
申请地址：企业支付宝后台
# 5-2-2 创建应用配置说明
1、首先要输入网址[app.hao071.com 用邮箱注册账号，参见下图：](http://app.hao071.com/)
2、登录进入注册的APP账号，点击【创建应用】选择版本（建议选择高级版本），再点击【立即购买】，参见下图：
3、输入网址就是输入外卖入口地址，点击【下一步】参见下图：
4、配置应用信息，参见下图：
应用名称：自定义设置应用的名称信息
应用说明：自定义设置应用的说明信息
状态栏：为更好的使商城APP兼容性高，选择显示
标题栏：选择隐藏
应用图标：应用的图标信息是用户下载APP时显示的图标，可自定义上传图片，参见下图：
启动图：是会员点击下载的APP进入的加载启动图，可自定义上传图片，参见下图：
5、信息填写完毕提交后，进入生成二维码页面，参加下图：
6、生成成功后，在应用列表中查看，直接点击任意二维码即可，参见下图：
# 5-2-3 微信登录参数设置
1、首先要点击【插件管理】，点击选择【微信登录】——【开启】——【参数配置】，参见下图：
2、再点击微信开放平台申请的链接[http://open.weixin.qq.com](http://open.weixin.qq.com/)，注册申请微信开放平台获取weixinAppid和weiXinAppSecret参数信息，参见下图：
3、注册登录后点击【管理中心】——【创建移动应用】，参见下图：
4、提交审核通过的移动应用，点击【查看】将weixinAppid和weiXinAppSecret参数信息复制到APP管理中心微信登录相应的参数设置中，注意：AppSecret需要点击【重置】开发平台不存储AppSecret信息，请妥善保存，参见下图：
# 5-2-4 微信支付配置说明
1、登录外卖APP管理后台，进入插件管理——微信支付
2、点击开启按钮，开启微信支付。
3、开启成功后，点击参数配置，进入参数配置项。
4、登录微信开放平台[https://open.weixin.qq.com](https://open.weixin.qq.com/)获取您申请的微信APP参数；
weixinAppiId为您在微信开放平台申请的‘’移动应用‘’的 APPID，如下图所示：
WeiXinAppSecret为您在微信开放平台申请的‘’移动应用‘’的AppSecret，如下图所示：
WX\_MCH\_ID 为您在微信开放平台申请的‘’移动应用‘’的微信支付的商户号（注意此处微信支付的商户ID并非您之前拥有的公众号的微信支付商户号，该处为您在微信开放平台创建移动应用后申请的微信支付商户号），如下图所示：
WX\_API\_KEY为您在微信开放平台申请的‘’移动应用‘’的微信支付的API秘钥（注意此处微信支付的商户ID并非您之前拥有的公众号的微信支付API秘钥，该处为您在微信开放平台创建移动应用后申请的微信支付API秘钥），如下图所示：
WX\_return\_url 为支付成功跳转的页面，填写格式如下：
http://[您的APP打包域名](http://xn--app-x69du0ojvbu1mvnx/addons/ewei_shopv2/payment/wechat/return.php)/addons/we7\_wmall/payment/wechat/return.php
WX\_notify\_url 为接受微信支付异步通知回调地址，填写格式如下：
[http://](http://xn--app-n82e60cwylxyry9cc16d/addons/ewei_shopv2/payment/wechat/notify.php)[您的APP打包域名](http://xn--app-x69du0ojvbu1mvnx/addons/ewei_shopv2/payment/wechat/return.php)/addons/we7\_wmall/payment/wechat/notify.php
###### *// 以上链接您可以通过在浏览器访问的方式，直接访问链接 返回fail，即为正常。*
5、进入外卖——设置——支付设置——APP支付设置，进行参数设置（注意此项微信支付参数，同样为您在微信开放平台内，申请的微信应用的微信支付参数，并非您公众号本身的微信支付参数），如下图所示：
6、注意事项
6.1 APP微信支付参数并非您的已有公众号的微信支付参数，为在微信开放平台申请应用后为应用单独申请的微信支付；
6.2 保存参数后，需要重新生成APP后方可生效，如果不成功请重启您手机上的测试软件iDev；
6.3 以上参数任何一个参数填写错误都将无法正常使用微信支付，请仔细核对检查
6.4 任何支付参数，请勿随意告知其他人（未避免纠纷请尽量自行设置）
# 5-2-5 QQ登录参数设置
1、首先要点击【插件管理】，点击选择【QQ登录】——【开启】——【参数配置】，参见下图：
2、再点击腾讯开放平台申请的链接[http://open.qq.com](http://open.qq.com/)，点击【应用接入】选择QQ号登录，再选择注册类型，申请腾讯开放平台获取App ID参数信息，参见下图：
3、注册登录后点击创建选择平台创建应用，参见下图：
切记，应用创建完毕后，在此应用平台信息管理下进行创建其他的应用。
比如：首先选择的平台是移动应用 安卓，则需要在此平台信息里面在进行申请IOS的应用。
这样才能是同一个APP ID，如果逐个创建应用的话则会有两个APP ID，而QQ登录只能填写一条APP ID参数信息，参见下图：
4、将创建应用后的APP ID直接复制到APP管理中心QQ登录中即可。
# 5-2-6 支付宝支付配置说明
### 外卖APP支付宝支付配置完毕后，可在APP内结算之直接唤起支付宝进行支付结算。
## **注：设置APP支付宝支付，PHP环境必须在5.4版本以上**
### **新版APP支付宝支付配置教程 [https://www.we7shop.com/videoplay/vid/44.html](https://www.we7shop.com/videoplay/vid/44.html)**
1、登录外卖APP管理后台
2、开启成功后，点击参数配置，进入参数配置项。
3、登录您的企业支付宝开放平台[ https://open.alipay.com](https://open.alipay.com/)，获取参数填写参数。
PARTNER为您在支付宝开放平台申请“合作伙伴身份PID”，如下图所示：
SELLER\_ID为卖家支付宝账号（您的企业支付宝登录账号）
NOTIFY\_URL 为支付宝异步通知回调地址，链接如下：
[http://您的APP生成域名/addons/we7\_wmall/payment/alipay/notify.php](http://xn--app-t33er8opzpdmcg94dyvc/addons/we7_wmall/payment/alipay/notify.php)[](http://xn--app-t33er8opzpdmcg94dyvc/addons/ewei_shopv2/payment/alipay/notify.php)
RETURN\_URL 为支付成功跳转页面，链接如下：
[http://您的APP生成域名/addons/we7\_wmall/payment/alipay/return.php](http://xn--app-t33er8opzpdmcg94dyvc/addons/we7_wmall/payment/alipay/return.php)
###### *// 以上链接您可以通过在浏览器访问的方式，确实文件是否存在于您的服务器上*
### 5、生成支付宝秘钥。
rsa\_private\_key.pem私钥
rsa\_private\_key\_pkcs8.pem PKCS8格式的私钥
rsa\_public\_key.pem 公钥
以上秘钥均需手动生成，请仔细根据教程操作
5.1 下载秘钥生成工具secret\_key\_tools\_RSA\_win.zip（请到外卖商业群内下载）
5.2 解压后进入RAS文件夹内openssl文件夹内，如下下图所示：
5.3 选中'**私钥转换PCKS8.bat**'文件，右键使用管理员方式打开，执行后会得到3个文件，如下图所示：
### 6、设置支付宝秘钥。
6.1登录支付宝开放平台[ https://open.alipay.com](https://open.alipay.com/)，点击进入‘’合作伙伴秘钥‘’，点击‘’上传开发者公钥‘’如下图所示：
如您未设置公钥，则此处显示未设置公钥，并非“查看开发者公钥”
6.2点击设置开发者公钥的，输入在5.3步中获取的rsa\_public\_key.pem文件中的字符（右键编辑文件打开直接复制到网页中）然后保存，如下图所示：
6.3返回‘’合作伙伴秘钥‘’界面，点击查看‘’支付宝公钥‘’，将秘钥复制至人人商城APP管理后台支付宝设置中的‘’支付宝公钥‘’（请仔细检查未包含任何空格），如下图所示：
6.4 右键打开5.3步中生成的文件‘’rsa\_private\_key\_pkcs8.pem ’，删除“-----BEGIN PRIVATE KEY-----”、“-----END PRIVATE KEY-----”，（请仔细检查未包含任何空格）复制剩余内容填写至外卖APP管理后台支付宝设置中的商户RSA私钥，如下图所示：
6.5进入外卖——设置——支付设置——APP支付设置，开启支付宝支付，将您在6.3步内获取到的支付宝公钥复制到支付宝公钥(public\_key)内，将您在6.4步内获取到的商户RSA私钥复制到应用私钥(private\_key）如下图所示：
上图中的APPID，在支付宝后台进行获取，参见下图：
外卖APP支付宝设置教程结束的，祝您配置成功。
# 5-2-7 微信开放平台应用创建操作
**1、填写创建应用的相关信息，移动应用名称、英文名称等信息（自定义）参见下图：**
**2、填写平台信息，官网信息、应用签名信息，参见下图：**
* 2.1IOS应用
请用安卓测试
* 上架后 Bundle ID填写自己设置的
* 2.2Android应用
应用官网：填写公司官网或外卖入口地址即可
应用平台：选择Android应用
应用下载地址：填写下载安装包的地址
应用签名：在APP管理中心中的【服务】——【分享设置】——【点击下载签名生成工具】，参见下图：
将下载下来的签名工具安装到手机上，获取签名信息，参见下图：
**注：此时需要在自己手机上安装自己的顾客端APP，才能生成签名**
应用包名：在APP管理中心中的【配置功能】——【分享Key设置】中获取应用包名信息，参见下图：
3、点击提交即可。
# 5-2-8 推送消息设置
### **登录外卖管理后台，点击配置功能，如下图：**
### **2.点击推送---推送接口，在推送接口页，推送消息下面找自己的APPID和key，将APPID和key复制到外卖后台设置--顾客APP设置里，如下图：**
# 5-2-9 顾客app设置教程
进入后台，设置-顾客app设置-基础设置，如下图：
appid和key需要去云打包后台获取，下面查看如何获取。
登录app后台，找到对应的应用，点击配置功能，如下图：
点击推送，如下图：
点击推送接口，下面推送消息里有appid和key，复制到外卖后台，如下图：
如还有问题请联系在线客服
# 5-2-10 修改打包的首页链接
登录app后台 ，找到对应的应用，点击配置功能，如下图：
点击底部导航，如下图：
点击修改，如下图：
修改首页链接，如下图：
如还有问题请联系在线客服
# 5-2-11 打包需要准备的资料
**顾客app打包及需要提供的资料（购买顾客app的客户必看）**
**1.提供授权站点url或授权域名**
**2.提供app的应用名称**
**3.提供平台入口链接**，如下图：
\*\*4.提供应用logo：\*\*180\*180、512\*512、1024\*1024（不能有圆角），类型：png；命名例如：某个图片的尺寸是180\*180， 则文件名为：180.png
\*\*5.提供应用启动页图片：\*\*1080\*1920、1125\*2436，类型：png；命名例如：某个图片的尺寸是1080\*1920， 则文件名为：1080.1920.png
**6.包名：**
自定义包名，安卓APP申请极光推送和高德地图都会使用到该包名。
包名命名规则：com.应用名称.customer，例如：
应用名称为：XX外卖，包名则为：com.XXwaimai.customer
**7.申请极光推送账号，申请成功后需要将AppKey和Master Secret写到申请资料里面， 提供给啦啦外卖官方。**
**具体申请步骤如下：**
(1) 首先注册极光账号，已有账号的直接登陆即可。登陆地址：[https://www.jiguang.cn/accounts/login/form](https://www.jiguang.cn/accounts/login/form)
(2) 进入管理控制台，点击创建新应用，应用名称自己设置。如下图：
(3) 应用创建完成以后，将AppKey和Master Secret写到申请资料里面
(4)设置应用信息， 这里需要特别注意， 应用包名为上述第6步自己定义的包名， IOS部分的设置暂时先不用设置
**8.申请高德地图key值，申请成功后需要将Key值写到申请资料里面， 提供给外卖官方。**
**具体申请步骤如下：**
（1）首先注册高德地图开放平台账号，已有账号的直接登陆即可。登陆地址：[http://lbs.amap.com/](http://lbs.amap.com/)
（2）右上角进入控制台，点击创建新应用，这里应用名称和类型自己设置，如下图：
完了以后点击创建。
（3）点击添加新key，设置应用信息，如下图：
key名称自己写，例如：顾客APP--安卓端；
服务平台选择Android平台；
发布版安全码：写固定值：10:49:D8:DD:46:78:44:77:8D:C6:1D:3B:75:45:B0:1B:8F:AE:81:76；
packgename：自定义包名，填写上述第6步自己定义的包名。
配置完成之后，将key填写进txt资料里。
（4）点击添加新key，设置应用信息，如下图：
key名称自己设置，例如：顾客-iOS版；
服务平台选择iOS平台；
安全码BundleID填写上述第6步自定义的包名；
配置完成之后，将key填写进txt资料里。
**9.申请微信开放平台账号，并创建应用审核通过后，提供AppID和AppSecret，提供给啦啦外卖官方。**
**具体申请步骤如下：**
（1）首先注册微信开放平台账号，已有账号的直接登陆即可。登陆地址：[](http://lbs.amap.com/)[https://open.weixin.qq.com/](https://open.weixin.qq.com/)
（2）创建移动应用，并审核通过后查看AppID和AppSecret，如下图：
填写用用名称，应用简介，应用官网，应用图片等信息，点击下一步，如下图：
选择Android应用，填写包名和签名，提交审核，如下图：
应用签名填写固定值：da0e7bf59ba96dbe821c18a176d9c028
应用审核通过后，点击查看AppID和AppSecreyt，如下图：
将AppID和AppSecret填写进txt资料里。
至此，顾客APP需要申请的资料到此结束，有问题联系在线客服咨询
# 5-3 商家端APP
## **注意**：app包名命名规则： com.应用名称的全拼.manager。例如：app名称为：外卖商家， 则对应的包名是：com.waimaishangjia.manager。包名会在申请极光推送appkey的时候用到。
商户APP需准备的资料：
1. 授权站点url：
2. APP应用名称：
3. 打包公众号uniacid： （教程是 [如何查看公众号uniacid](https://www.kancloud.cn/w509778577/a005/1701883)）
4. 应用logo：（16\*16、180\*180、512\*512、1024\*1024，类型：png；命名严格按照logo及启动页文件夹里的图片命名）
5. 应用启动页图片：（1080\*1920、1125\*2436，类型：png；命名严格按照logo及启动页文件夹里的图片命名）
6. 包名:
7. 极光推送账号:
8. 密码:
9. 极光推送appKey：
10. 极光推送masterSecret:
（注意：这里的appkey和masterSecret需要使用新包名创建应用，进行申请，跟配送员资料里的不一样）
## **极光推送申请步骤：**
先登录极光开发者服务网站，网址为：[https://www.jiguang.cn/（没有账号的先注册）](https://www.jiguang.cn/%EF%BC%88%E6%B2%A1%E6%9C%89%E8%B4%A6%E5%8F%B7%E7%9A%84%E5%85%88%E6%B3%A8%E5%86%8C%EF%BC%89)
第一步，创建应用
第二步，填写应用名称，上传图标，如下图
第三步，将appkey和sercet复制粘贴出来，发给开发者
第四步，点击完成推送设置，如下图
第五步，安卓部分填写应用包名，命名规则：com.应用名称的全拼.manager。例如：app名称为：外卖， 则对应的包名是：com.waimai.manager。
11.申请高德地图key值，申请成功后需要将Key值写到申请资料里面， 提供给团队官方。
具体申请步骤如下：
（1）首先注册高德地图开放平台账号，已有账号的直接登陆即可。登陆地址：[http://lbs.amap.com/](http://lbs.amap.com/)
（2）右上角进入控制台，点击创建新应用，这里应用名称和类型自己设置，如下图：
完了以后点击创建。
（3）点击添加新key，设置应用信息，如下图：
key名称自己写，例如：商家APP--安卓端；
服务平台选择Android平台；
发布版安全码：写固定值：10:49:D8:DD:46:78:44:77:8D:C6:1D:3B:75:45:B0:1B:8F:AE:81:76；
packgename：自定义包名（例如：com.lalawaimai.manager），填写上述第6步自己定义的包名。
配置完成之后，将key填写进txt资料里。
（4）点击添加新key，设置应用信息，如下图：
key名称自己设置，例如：商家--iOS版；
服务平台选择iOS平台；
安全码BundleID填写上述第6步自定义的包名；
配置完成之后，将key填写进txt资料里。
## 注：需要上架的提供下述资料，不上架的忽略
（iOS上架需要提供资料）
苹果开发者账号：
密码：
姓名：
电话号码：
电子邮件：
商家账号：
商家密码：
# 5-5-1 后台上传APP安装包到服务器
进入平台后台应用-商家APP/配送员APP/平台管理APP，上传安装包，如下图：
要使用后台二维码下载APP或者扫码下载出现404文件不存在，必须先上传安装包，才可以下载。**注意：小程序独立版不支持二维码下载APP。**
# 5-5-2 APP的必要设置
在后台应用-配送员/商家app里设置，现在以配送员app为例进行设置
1.APP设置基础设置，如下图：
2.极光推送key和极光推送Secret在极光后台去查看，如下图：
点击查看，Master Secret的值就是极光推送Secret的值，如下图：
3.上传安装包，如下图：
