1.Google后台应用配置
google控制台地址:https://console.developers.google.com
Google后台配置简要流程如下:
1.1 Google API控制台公共项目配置:
上图中的所涉及到的流程在后续章节中都有详细指引。
简要流程:
1.API控制台创建一个公共项目用于Play 控制台关联(如果已经有关联的项目则不需要再创建,一个主开发者帐号只能关联一个项目)
2.Play控制台关联API控制台的公共项目
3.API控制台中在公共项目中创建服务者账号,下载P12证书文件
4.Play控制台中为服务者帐号开放权限,目前只需要查看财务权限
5.将P12证书文件和服务者帐号保存至WA后台
1.1.1 API 控制台创建新的公共项目
打开Google API控制台,创建一个新的控制台项目
注册账号后,开Google API 控制台,创建一个新的公共项目,
注意:如果使用现有的公共项目(Google Play Console已关联的项目),可以不新建。
点击”新建项目”
在”新建项目页面”输入项目名称,点击“创建”新建即可完成新项目创建
项目名称需要保存记录,对应windsdk后台中,添加google支付平台的需要填写的应用名称栏目
1.1.2 控制台关联公共项目
打开Google Play开发者控制台,在设置->API权限->关联项目中,关联前面创建的公共项目。如果已关联,则下一步在已关联的项目中创建“服务者账号”即可。:
1.2.API控制台创建服务账号(Service account key)*
服务帐号是SDK后台验证支付订单时候使用,运营人员需要将服务帐号和证书保存至SDK后台。SDK后台的操作请参考《WINGSDK后台基础设置》 。不同的应用,不要使用相同的服务帐号。
打开Google API控制台,选择公共项目,进入项目“API和服务”中的“凭据”页面
在“凭据”页面,点击“创建凭据”,选择“服务账号”
进入“创建服务账号”页面,第一步填入“服务账号名称”
第二步选择服务账号“角色”,分配“Editor”角色,然后点击“继续”
第三步中直接点击“完成”即可
接下来在公共项目的“凭据”中“服务账号”列表找到刚创建的“服务账号”
点击进入该“服务账号”的编辑界面,选中“密钥”标签,点击“添加密钥”并选择“创建新密钥”
在弹出框中选择“P12”类型私钥,点击“创建”
点击“创建”后,浏览器会自动下载“P12”私钥文件
“P12″私钥文件需要妥善保管,在WingSDK后台中添加Google支付平台时会要求上传该文件。
1.1.4 Play控制台“服务账号”权限配置
创建“服务账号”完毕后,在Google Play控制台,设置->API权限的页面的“服务账号”列表中,可以找到新创建的“服务账号”查看并修改权限
选中“账号权限”标签,只勾选“查看财务”权限即可
选中“应用权限”标签,添加该“服务账号”对应的游戏,点击“应用”
在弹出框中确认已勾选“查询财务数据”权限,点击“应用”完成添加
完成“应用权限”和“账号权限”配置后,点击“邀请用户”发送邀请
之后可以在“API权限”的“服务账号列表”中看到该“服务账号”已经是“有效”的状态
进行完上述操作之后,将“服务帐号”(即邮箱)和“P12”私钥文件保存至WA后台即可。
1.3 Google API控制台游戏项目配置
简要流程:
1.创建专用于游戏的新项目
2.在游戏项目中新建Web类型ClientID,用于WA后台Google登录配置
3.在游戏项目中新建Android类型ClientID,需要研发提供包名(PackageName)和应用签名jks文件的SHA-1信息
1.3.1 创建专用于游戏的新项目
同上面公共项目创建一样,新建一个专用于游戏的项目
1.3.2 启用Google+ API
在游戏项目中,选择进入“API和服务”中的“已启用的API和服务
在“已启用的API和服务”界面,选择“+启用API和服务”,进入“API库”界面
在“API库”中,搜索“Google+”,选择并进入“Google+ API”
在“Google+ API”产品详情页面中,点击“启用”
1.3.3 同意屏幕配置
在添加OAuth Client ID之前,必须先完成“同意屏幕”配置。“同意屏幕”会影响用户授权是看到的界面,如下:
首先在前面新建的专用于游戏的“项目”中,进入“同意屏幕”界面,操作如下
在“同意屏幕”配置界面,UserType选择“外部”,然后点击“创建”
第一步,填入“应用名称”和“用户支持电子邮件”,以及“开发者联系信息”,这几项都是必填项目。
其中“应用名称”将会是用户授权登陆时看到的应用名称,其他可选项根据实际情况决定是否填写,下面是可选项的影响及要求:
1.应用的徽标和名称:建议使用徽标,但不强制要求使用
2.用户可以用来与您联系的电子邮件地址以及范围列表:范围是您的应用对访问用户的 Google 帐号以及会共享哪些数据的具体请求。您将在下一步中添加范围。
3.指向应用隐私权政策和服务条款的链接
此部分内应包含:
一个描述用户可以如何管理对其 Google 帐号的访问权限的句子
一个指向 Google 文章的链接,其中介绍了 Google 如何帮助用户安全地共享其数据
第二步数据访问“范围”配置,这一步无需处理,直接下一步即可
第三步“测试用户”配置,这一步也无需配置,直接下一步
第四步“摘要”,到这一步已经完成“同意屏幕”配置,可以在“摘要”界面审查自己的配置,也可以直接返回。
1.3.4 创建Web类型OAuth Client ID
进入游戏“项目”的“凭据”界面,点击“创建凭据”选择“OAuth客户端ID”
在“应用类型”中选择“Web应用”类型
填写“名称”,然后点击“创建”即可完成创建
在创建完成提示界面中,可以直接 复制刚创建的“Web客户端ID”保存,后续将需要提供给研发和WA后台Google登录配置。
1.3.5 创建Android类型OAuth Client ID
跟创建Web应用“OAuth 客户端 ID”类似,在游戏“项目”的“凭据”界面中创建“OAuth客户端ID”,但是类型选择“Android”
填写“名称”,“包名”,“SHA-1证书指纹”,其中“包名”和“SHA-1”都由研发提供,获取指引如下:
包名:Android项目的applicationId,在“应用层级”的build.gradle文件中的android->defaultConfig->applicationId找到,具体参考下图
SHA-1证书指纹:首先需要研发创建游戏的“正式应用签名jks文件”,然后使用下方命令输出“SHA-1证书指纹”信息,输出结果参考下图
命令:keytool -keystore path-to-debug-or-production-keystore -list -v
创建完成之后,一般“隔天”会生效,生效后就可以正常进行Google登录
1.4 Play控制台更改应用签名密钥
为了确保由研发生成的“正式应用签名jks文件”在GooglePlay中正常生效,需要在Play控制台更改应用签名密钥。
Play控制台中选择游戏应用,在“内部测试”轨道中选择“创建新的发布版本”或“修改发布版本”
不需要上传应用,直接点击“更改应用签名密钥”,在弹出的确认框中点击“使用其他密钥”
接着在“应用签名偏好设置”界面中,选择“从Java密钥库导出并上传密钥”,在这里按照指示完成“zip文件”上传,最后点击保存。具体指示说明参考下图
保存完成之后,可以在游戏应用的“设置”->“应用完整性”中找到Play中已生效的“SHA-1”信息,把这个跟前面研发提供的“SHA-1”进行比对,一致则说明配置正确,否则需要重新配置,同样是从“内部测试”的“更改应用签名密钥”开始。
1.5 Google Play添加应用内商品
添加应用内商品前,按要求需要先上传有BILLING 权限(接入WingSDK的Google模块默认带有该权限)的应用包,建议在“内部测试”完成上传,上传应用包即可达成条件,无需发布。
单个商品创建
在游戏应用的“应用内商品”界面,可以“创建商品”
按照提示填写完成对应项,最后点击“保存”,其中“设置价格”和“税费和法规遵从设置”界面如下图
注意:商品ID是唯一的,即使被删除后也依然占用原ID。
保存之后,商品默认是“无效”状态,需要点击“启动”改为“有效”状态
“启用”商品之后,在应用内对应商品详情界面,可以进行停用及删除
批量导入商品
GooglePlay后台目前支持批量导入,因为csv模板可能会变更,所以建议先创建一个商品,再导出,根据导出的最新csv模板样式,添加商品,再保存csv文件上传导入。
同样是在“应用内商品”界面,先根据上一步操作创建一个商品,然后点击“创建商品”旁边的选项“图标”,选择“导出”
导出的商品csv文件内容如下图,再参考已有的导出商品,按照相同方式补充完剩下的商品,保存商品csv文件
同样是“应用内商品”界面,点击选项“图标”,选择“导入”
导入最新的商品csv文件。注意:批量导入,如果csv商品文件中包含已有商品则会修改对应商品内容。
导入完成之后就可以在列表中看到所有已导入的商品
注意:如果文件内容中有中文,那么csv文件可能存在乱码问题,如果有这种情况,需要把csv的编码改为utf-8,确认中文字符正常,再保存上传。
1.6 添加Google Play测试用户
在应用未正式发布前,Google支付可以在Google Play添加测试用户才能进行沙盒测试。
详细的GooglePlay应用测试说明和方法可参考下方官方文档:
https://support.google.com/googleplay/android-developer/answer/9845334
“封闭式测试”和“内部测试”:
进入游戏应用的“内部测试”轨道(“封闭式测试”也相似),在“测试用户数量”标签中,如果勾选“已有测试列表”,如果没有则“创建电子邮件列表”再勾选(创建界面截图如下),然后保存。保存之后可以复制“测试邀请链接”,发给测试人员。
测试人员在浏览器上登录被邀请的Google账号,然后打开“测试邀请链接”,点击“接受邀请”
“接收邀请”之后,测试人员根据指示下载测试版应用安装测试
2.正式发布阶段
将测试者的email添加到google控制台的测试者账户中,具体可参考:
http://developer.android.com/google/play/billing/billing_admin.html#billing-testing-setup
具体以官方说明为准,截图可能会过期。
1.7.添加Google Game Service支持
在开发者管理者控制台左侧菜单打开“游戏服务”菜单,在列表中选中需要新建成就的游戏服务。
如看不到Play 游戏服务,则在顶部搜索栏中搜索”Play游戏服务设置”,然后选中
选中“是,我的游戏已经使用了Google API”,此时在下方选择要关联的项目。选择项目,下一步即可完成创建。(如没有创建Google API项目,则参考 1.3.子项目中配置应用的OAuth Client Id* 流程先创建子项目)
在游戏服务中添加新游戏之后自动生成了Google Game Service App Id,此值需提供给开发人员,如下图所示:
如提示配置OAuth同意屏幕,按照要求操作同意接口,同意完后,点击添加凭证,选择Android类型,输入名称等基本信息,选择OAuth客户端即可,然后保存。(默认情况下选择OAuth客户端只有一个,如若多个,可以选择后,查看包名和指纹是否和应用的一致进行确认)
创建完游戏服务之后就可以创建成就和排行榜了,创建完的游戏服务,必须要发布才能够使用。
在goolge应用控制台为某一个应用添加Google Game Service成就,请参考以下官方文档:
https://developers.google.com/games/services/common/concepts/achievements
在左侧菜单选择“成就”,点击页面“添加成就”可以添加新的成就。
1.8.获取Google Play Public Licensing Key (3.9.0版本及以后不需要配置)
1)打开Google Play后台,确认登录的账号是已经或者将要发布应用的账号
2)点击所有应用->选择应用->点击获利->获利设置
3)在“服务和API”页面的“许可和应用内结算”部分,就可以找到public licensing key
如图:
1.9.Google 促销商品配置
参考地址:https://developer.android.com/google/play/billing/promo
登录Google Play后台,选择对应应用进入详情,选择获利—产品—促销代码,点击创建促销代码
输入 促销活动名称、开始时间、结束时间,促销类型选择应用内商品,然后选择需要参与促销的商品,输入促销代码数量,保存即可。
当到达输入当开始日期时间后,促销码就可以使用。在您的应用中:用户可以点击 Google Play 购买屏幕中付款方式旁边的向下箭头,然后点击兑换链接以输入代码,由此发起购买交易
选择兑换代码,输入对应兑换代码
注:创建促销商品的商品id为google_001,在应用内兑换时,需要点击相对应的商品(对应google商品id为google_001)弹出支付界面,然后输入兑换码才能正常兑换。
1.10.Google Play 签名密钥
Google Play控制台的签名密钥有两种,一种是应用签名密钥,一种是上传签名密钥,他们对应的实体文件是keystore/jks文件。
上传签名密钥:上传Google Play 的aab或apk包必须使用该签名秘钥进行签名,不能使用应用签名秘钥或者其他签名秘钥,否则会提示签名错误,无法上传。
应用签名密钥:是应用最终所使用的签名密钥。虽然上传Play使用的是上传签名秘钥签名,但是正式上架对外时,Google Play会抹去原来的签名,并使用应用签名秘钥签名。无论对外发布,或者给一些平台配置如Google和Facebook,或者用于应用调试测试,都应该使用应用签名密钥
为了方便管理,建议“应用签名密钥”和“上传签名密钥”使用相同的签名密钥jks文件
说明:使用下面步骤,不包含“上传签名密钥”的配置,因为Google不允许两个签名一致,但是“更改签名密钥”时不进行“创建新的上传密钥”即可让两个签名保持一致。
1.10.1.Google Play 签名密钥
首次创建应用版本会要求加入谷歌签名计划,在加入谷歌签名计划时候,默认由谷歌自行创建签名密钥,它会保存在谷歌服务器,无法访问和下载。默认方式的签名密钥文件不可访问,无法控制,不利于管理签名密钥文件和调试测试,所以建议上传自己的签名密钥。
为了方便管理,建议“应用签名密钥”和“上传签名密钥”使用相同的签名密钥jks文件
说明:使用下面步骤,不包含“上传签名密钥”的配置,因为Google不允许两个签名一致,但是“更改签名密钥”时不进行“创建新的上传密钥”即可让两个签名保持一致。
上传自己的签名密钥
创建应用版本会默认加入Google签名计划,该计划实际内容是:由Google自行创建签名密钥,并保存在谷歌服务器,无法访问和下载,最终向用户分发应用时再由Google进行签名。默认方式的签名密钥文件不可访问,无法控制,不利于管理签名密钥文件和调试测试,所以建议上传自己的签名密钥。
注意:这一步,是应用未正式上架时可以重复操作修改的,但是正式上架后不可用再从这里修改,需要参考下一章节执行“升级密钥”操作才可更改。
具体操作同《Play控制台更改应用签名密钥》一致,最终验证“应用签名密钥证书”和“上传密钥证书”保持一致即说明配置正确。
1.10.2.验证签名密钥配置
1.研发在命令终端通过输入keytool命令获取签名密钥jks文件的证书指纹。
命令:keytool -list -v -alias ALIAS_NAME -keystore KEYSTORE_PATH
2.在Google Play控制台的,设置->应用完整性,中找到当前生效的密钥证书信息
1.10.3.升级应用签名密钥
适用应用:已上架,并且之前执行过“更改应用签名密钥”,把默认的Google签名改为自己签名文件的应用
不适用应用:
1.未上架,无需升级也可在“内部测试”中选择“更改应用签名密钥”进行更改
2.已上架,但是之前默认由Google签名(未执行过“更改应用签名密钥”)操作,界面参考下图
使用“Google生成的签名”的应用,会没有“请求升级密钥”按钮
升级注意:“请求升级密钥”操作,一年只有一次机会,无法撤销,请谨慎操作
同样是“应用完整性”页面,在“应用签名”标签里面找到“请求升级密钥”按钮,并点击
在弹出框中,【关键】首先展开“隐藏选项”,选择“所有Android版本的所有安装”选项。然后升级方式选择“从Java密钥库上传新的应用签名密钥”
按照“从Java密钥库上传新的应用签名密钥”的指示,下载PEPK文件给研发使用,研发使用指示命令生成zip文件,其中命令的黑体参数需要替换为本地对应参数,具体参考如下,最后完成“上传zip文件”,选择“升级原因”,点击“升级”。
foo.keystore:新的应用签名密钥jks文件
foo:foo.keystore文件使用的别名
upload.keystore:原应用签名密钥jks文件
upload-key-alias:upload.keystore文件使用的别名
注意:若upload.keystore使用的不是原应用签名密钥jks文件,会升级失败
在弹出框中确认升级影响目标必须是“所有Android版本上的新安装”,若不是则需要修改前面“隐藏选项”的选择。
确认升级影响目标正确后,点击“确认”完成升级。
升级之后可以在“应用完整性”的“应用签名”标签中,确认最新生效的“证书指纹”信息,也可以查看“曾用密钥”的证书指纹信息。另外升级后“请求升级密钥”按钮变为不可用状态,并且旁边会有显示上一次的升级日期
更多内容可以查看Google文档了解:
https://support.google.com/googleplay/android-developer/answer/9842756
1.10.4.升级前的重要注意事项
无论是“上传自己的签名密钥”或者“升级应用签名密钥”,都会影响应用的验证,比如Google登录,Facebook登录等三方功能,所以修改后确认同步修改对应平台相关内容。
如果是未上架应用“上传自己的应用签名密钥”,更改原有对应配置即可。
如果是已上架应用“升级应用签名密钥”,为了保证旧的“应用签名密钥”用户也可以暂时使用,保留“原应用签名密钥”证书指纹相关配置,并添加新的“新应用签名密钥”证书指纹相关配置。
下面罗列一些平台需要用到签名信息的相关配置指南:
Google:Google Cloud Platform(https://console.cloud.google.com/)控制台,API和服务 -> 凭据中,添加Android类型的OAuth 2.0 客户端 ID,输入包名和新的应用签名的SHA-1证书指纹。子项目中配置应用的OAuth Client Id
Facebook:Facebook登录的“密钥散列”与应用签名有关,需要添加新的“密钥散列”。
添加签名密钥散列
Fireabse:关联应用有用到应用签名的SHA-1和SHA-256证书指纹,需要添加
手动关联GooglePlay应用
Huawei:华为应用需要配置证书指纹。
生成签名证书指纹
1.10.3.4 签名密钥常见问题
1.打包的时候该使用哪个签名密钥?
上传签名密钥,只有在给需要上传到Google Play任意轨道(测试或正式等)的应用包打包时使用。
其他任意时候,比如想在本地运行调试,或者本地打包测试,只要不需要上传到Google Play的,都使用应用签名密钥进行打包。
2.MD5,SHA-1,SHA-256这些证书指纹该用哪个签名密钥的?
上传签名密钥只有在上传Google Play任意轨道时候打包应用包时使用,其他任何情况都以应用签名密钥为准。所以给Google,Firebase,Facebook,Huawei等平台提供的SHA-1,SHA-256证书指纹都需要使用应用签名密钥的证书指纹。
3.什么是keystore/jks文件,怎么生成的?
二者是同一个东西,都是Android签名密钥文件,用来打包Android应用的,当前常用的是jks文件。该文件用于确保应用的唯一性及合法性,非常重要,请务必保管好该文件及相关的密码,并确保不会泄漏。
虽然可以使用JDK的keytool工具生成这两种文件,但常用的方式是开发者使用Android Studio生成jks文件,而keystore文件一般使用Eclipse生成。
4.Google Play上的应用签名密钥keystore/jks文件找不到了,能否重新生成一个跟上面相同证书指纹的签名密钥文件?如果不能又该如何处理?
不能生成指定证书指纹的签名密钥文件。Google Play上也无法下载签名密钥文件。
处理方法:
1)上传应用到任意轨道(正式或测试),从Play Store的应用页面下载应用,上面下载的应用都会使用应用签名密钥打包签名过。
2)如果想自己重新掌握keystore/jks文件,并且Play控制台中该应用未升级过应用签名密钥(每个应用只有一次升级机会),可以进行密钥升级,更换为新的keystore/jks文件信息。升级的时候务必选择“上传自己的签名密钥”,不要选择默认的“由Google Play生成。。。”,升级成功后也务必对一些平台上的配置做出相依的配置改动,否则会影响这些平台的API使用,如Google登录,Facebook登录等,具体升级请参考“升级应用签名密钥”章节操作。
5.应用打包运行之后的签名密钥,和Play上的应用签名密钥不一致会有什么后果?
通常会影响所有配置了与应用签名密钥有关信息的平台API。比如Google的Android类型OAuth ClientID使用了SHA-1,会影响谷歌登录,导致谷歌登录直接返回取消。Facebook使用的散列秘钥,影响Facebook登录。其他的还有Firebase的应用关联,Huawei的应用配置。
1.11Google Play 发布应用
准备应用包:
使用上传签名密钥打包签名好应用包apk或aab。若使用应用签名密钥或其他签名密钥,会提示错误。关于签名密钥可以参考上一章节说明。
注意:推荐aab,2021年8份起新应用必须使用aab包发布应用。Play发布的apk大小限制为100MB,aab大小限制为150MB,若超出大小限制,apk包需要使用APK拓展文件obb功能,aab需要使用Play Asset Delivery功能,对应用或游戏资源进行配置,才能上传成功。
登录Google Play 控制台,选择并进入需要发布的应用。
1.选择发布的版本,根据需要可以选择内部测试,封闭测试,开放性测试,正式版。
2、若是测试轨道,可以选择测试人员并保存
3.若是开放性测试,或正式版,需要设置发布的国家。
4.创建新版本,上传应用包,保存。若之前已上传过该应用包,可以直接从内容库中选择。保存之后,点击检查发布版本。
5.在检查发布版本页面,查看所有错误警告消息,若是错误,必须按照指引完成修改。完成所有错误的修改后,回到该页面,点击 开始发布,即可完成操作,等谷歌审核通过后,即是正式完成发布。
其他说明:发布前错误提示,信息中心需要完成步骤,主要是设置应用部分,按照指引完成任务即可。
1.12.Google广告ID声明设置
选择应用》应用内容》广告 ID进入声明设置
使用广告ID项选择 “是”,使用方式选择,“分析”,“广告或营销”,点击保存。
2.Facebook第三方后台配置
2.1 Facebook基础配置
Facebook控制台地址:https://developers.facebook.com/
2.1.1 创建Facebook应用
一共有五种可选的应用类型:公司、游戏、小游戏、消费者或无。当您选择应用类型后,系统会为应用提供仅适用于该应用类型的产品(如登录,分析等产品)、权限(访问用户生日性别照片等数据权限)和功能,精简应用创建流程。
1、公司类型适用于可帮助公司和组织管理公共主页、小组、活动、广告以及和广告相关素材的应用。
2、游戏类型适用于可以在 Facebook 开放平台上游玩的游戏应用。
3、小游戏类型适用于可以在 Facebook 开放平台上游玩的游戏应用。
4、消费者类型适用于整合 Facebook 登录等消费者相关产品以便为用户提供更多帐户关联体验的应用程式。
根据说明,上面的“游戏类型”是适用Facebook游戏平台上的游戏。我们推荐创建应用类型时,选择“消费者”类型,该类型包含Facebook登录,分析,应用事件,应用链接,Instagram基本显示API,分享,社交等常用的产品。
想了解所有应用类型对应可使用的产品、权限和功能,可以查看Facebook官方文档: https://developers.facebook.com/docs/apps/app-types/
进入应用控制台,点击“创建应用”。
点选择用途“打造关联体验”(对应消费者应用类型),点击“继续”。
填写“应用显示名”,和“应用联系邮箱”,点击“创建应用”。
“创建应用”完成以后会立即进入到该应用的控制台页面。
移除应用类型
如果选择应用类型之后,在产品添加中没有找到自己需要的产品,或者当前应用类型提供的权限或功能无法满足需求,可以移除该应用的应用类型,或者重新创建新的应用类型的应用。移除应用类型之后,就是无指定类型的应用了,可以选择添加任何产品和申请任意权限及功能。
注意:移除类型后是无法再次指定应用类型的。
下面介绍如何移除应用类型:
进入目标应用控制台页面,点击“产品 +”,往下滑,找到“想找其他产品和权限?”卡片,点击“移除应用类型”按钮。
输入该账号的密码,点击“提交”
操作完成之后,在应用控制台中可以看到,已经不再显示应用类型了,并且可添加产品中,显示了所有的产品,权限页面也可以看到显示所有权限。
2.1.2 添加产品
创建完应用编号后,需要添加产品。点击左侧菜单栏中的“产品+”按钮,找到所需的产品,点击该产品卡片的“设置”按钮进行添加。(接下来以必接的登录功能为示例,另外在这里只需要对产品进行设置,所以会忽略其他非设置步骤)。
2.1.3 设置项目信息
点击“设置”进入产品添加的向导(菜单栏“快速启动”方式设置),选择添加的产品支持的平台(此处以Android平台为例)
图:选择产品支持的平台
选择平台后,进入平台的设置页面,在这个页面可以在上面的tab中切换不同的平台进行设置,第1、2步是SDK集成,由开发人员完成,进入第三步设置项目信息。
输入应用包名,和默认活动类的完整路径(如果使用DeepLink功能,需要填入DeepLink功能响应的Activity类路径,否则可以填入首个启动的Activity,例如MainActivity即可),点击“Save”保存。
图:填写Android项目信息
点击保存,如果你的应用在Google Play没有上架,会弹出下图“Google Play包名校验遇到困难”的对话框,点击“使用此包名”即可。
图:Google Play包名验证出现困难
2.1.4 添加签名秘钥散列
签名秘钥散列需要开发技术同事协助获取,获取到的字符串是包含 28 个字符的唯一密钥散列,获取方式参考Facebook官方文档。将生成的秘钥散列添加到“秘钥散列”下面的文本框,如果测试环境和正式环境不一样的签名文件,这里可以添加多个。添加后点击“Save”保存。
具体操作过程可以参考以下任何一种方式,他们都是相同的指引,然后按指引生成“发布密钥散列”进行添加:
1.Facebook控制台 -> 产品 -> Facebook登录 -> 快速启动 -> Android平台 -> 添加开发和发布密钥散列
2.Facebook登录接入文档,第6节-为应用提供开发和发布密钥散列:
https://developers.facebook.com/docs/facebook-login/android#6
2.1.5 启用单点登录
根据需求,如果需要启用单点登录,打开单点登录,保存进入下一步。
图:启用单点登录
Facebook的基础配置已经完成,接下来的6、7、8、9、10是开发人员的集成步骤,集成参考文档《WING SDK使用指南(Android).doc》,如果需要进行其他设置,请参考后续章节。
2.1.6 其他配置及提供参数信息给技术配置到工程项目中
在左侧菜单点开“设置->基本”,将应用编号(Facebook App id)提供给技术配置到项目中,如果需要礼物功能,需要将应用密钥(App Secret配置到SDK后台,关于礼物的配置参考后续章节。如果需要使用游戏邀请功能,必须在设置中设置应用的类别为“游戏”
往下滑动,可以看到上面添加的Android平台的配置,可以在这里修改配置。如果需要添加其他平台,可以点击“+ 添加平台”按钮添加(如果添加产品的时候,针对某个平台进行了配置,会自动添加了该平台)。
2.1.7 相关产品的配置修改
如果需要修改相关产品的配置,在左侧菜单中的“产品”中找到相应的产品,“设置”展示所有设置,“快速启动”是包含了向导的设置。
图:产品配置修改
2.2 Facebook添加开发者
添加步骤如下:
在Facebook控制台页面,在左侧“用户身份”菜单展开,下面有两个,“用户身份”和“测试用户”。“用户身份”是配置哪些用户拥有编辑和查看应用的权限;“测试用户”用来测试不同应用功能的临时性的 Facebook 帐户。
图:用户身份配置
2.3 上线注意事项
切换到线上模式,必须提供“隐私权政策网址”和“数据删除信息”。
“隐私权政策网址”必须提供有效的地址,在Facebook登录页面和应用详情页面会显示该入口。
“数据删除信息”,Facebook为了符合通用数据保护条例 (GDPR),可获取用户数据的应用程序必须执行以下某项操作:
1.执行数据删除请求回调。
2.为用户提供含有明确说明的网址,介绍如何使用第三方网站或工具删除数据。第三方网站可能是应用程序隐私政策的相关部分。
用户在Facebook设置中移除应用时候,会有提醒用户移除数据的相关说明。
第一种方式需要按照官方文档要求提供接口给Facebook调用。我们建议选择第二种方式,提供数据删除说明地址,介绍如何删除数据。
图:切换线上模式提示框
图:选择 数据删除说明网址
图:选择 数据删除说明网址
3.VK后台应用配置
VK目前必接的功能包括登录,登出,显示用户名称以及头像,group和邀请。
3.1. VK基础配置
创建VK应用,创建地址如下(如果还没注册,需要先注册):https://new.vk.com/editapp?act=create
title中填入应用的名称, 点击Connect Application按钮,并按照提示创建应用。填写关键信息,主要是填写Information和Settings部分:
上图的SDK settings中安卓部分需要填写应用的包名和指纹,指纹的获取方式请参考1.1 配置应用程序证书指纹(去掉冒号),也可以参考:https://new.vk.com/dev/android_sdk,或者与开发人员联系获取。
获取vk app id提供给开发人员并且注意设置应用状态为可见
3.2 应用提交审核
VK的邀请功能是对接VK渠道官方要求必须接入的,而邀请功能只能在审核通过的应用中使用,所以需要将配置好的应用提审。
这里需要注意的是:
VK的应用审核比较严格,首先必须是游戏应用,并且需要全部翻译成俄文,不能是demo,有人工审核。
如果需要测试邀请,原则需要审核过的应用,在应用审核通过之前,使用apps.sendRequest接口,type为request来测试,测试者需要双方是好友,都是管理员并且都已经安装过该应用。
对接VK邀请功能业务流程图如下:
控制台提审大致步骤如下:
4.Firebase后台配置
在Firebase后台配置后,会得到两个文件,一个是google-services.json,需要给研发配置到游戏中去;另一个是Firebase服务器秘钥,需要配置到SDK后台
4.1 新建Firebase项目
在浏览器中打开Firebase控制台点击添加已经在Google API存在的项目
点击输入项目名称输入框时,会弹出已经存在Google Api的项目列表,选择对应项目并继续
选择配置Google Analytics账号,点击添加Firebase按钮
点击继续,则项目创建完成。
4.2 新建应用
进入项目,点击对应应用类型
输入软件包名、应用名、SHA-1指纹,点击注册应用
注册应用,进入下一步,下载google-services.json。将下载的配置文件复制到项目模块文件夹,通常为 app/。
google-services.json文件可以随时重新下载,可以在设置,常规,选中项目后,下载某个项目的google-services.json文件,如果包名改变,或者其他配置更新,则需要重新下载google-services.json文件,然后更新到项目中去。
4.3 获取Firebase服务器秘钥
在项目详情左侧菜单中点击设置按钮进入设置页面,选中云消息传递标签,在页面上可以找到服务器秘钥(请使用新版的服务器秘钥)。
4.4 将Google Play链接到Firebase
1、登录到Firebase
2、单击设置图标,然后选择项目设置
3、单击集成 选项卡
4、在Google Play卡上,点击链接,如果您的项目已被链接,则会看到“ 管理”,如果您没有Google Play开发者帐户,则可以点击升级和链接以创建一个新帐户。
说明:必须链接到Google Play账号才能查看Android应用的in_app_purchase和订阅事件。需使用主账号进行关联
已关联Google Play账号的的项目,如若继续添加应用,则需要手动关联Google Play应用
然后点击添加SHA-1 、SHA-256指纹查找方式为:在googleplay后台–设置–应用签名—-应用签名密钥证书,SHA-1、SHA-256指纹。
然后需要重新下载最新的google-services.json配置文件,给到研发进行更新
注:应用不需要上架正式版,但是需要至少上架一个内测版本才能关联成功
4.5 Firebase 分析调试
参考:https://firebase.google.com/docs/analytics/debugview?authuser=0
要在 Android 设备上启用 Analytics“调试”模式,请执行以下命令:
1 2 |
adb shell setprop debug.firebase.analytics.app package_name |
例如:adb shell setprop debug.firebase.analytics.app com.ghw.sdk2
“调试”模式将保持启用状态,直至您通过执行以下命令明确停用“调试”模式:
1 2 |
adb shell setprop debug.firebase.analytics.app .none. |
开启调试后,打开管理后台,选择项目–分析–DebugView,能够看到目前正在调试的设备,以及上传的事件。
注意:为了防止测试和开发影响测量值,在调试模式下记录的事件将从总体 Analytics 数据中排除,并且不会包含在每日 BigQuery 导出报告中。
5.Twitter后台配置
5.1 Twitter后台应用配置
注册一个Twitter账号,打开Twitter开发者页面,如果您的Twitter账号不是开发者账号,还需要将Twitter账号注册成为开发者账号。进入My Apps页面,可管理应用。如果还没有应用,点击“Create New App”进入创建应用界面,填写相关信息新建应用。
新建应用后,点击应用列表中的应用,可以查看应用的详情。
点开“Keys and Access Tokens”标签可以看到ConsumerKey和ConsumerSecret
5.2 WINGSDK后台应用配置
将Twitter中新建应用的consumeKey和ConsumeSecret配置到WINGSDK后台。选中应用→设置→登录平台→添加Twitter登录平台,在“平台应用ID”中填写consumeKey,在“公钥”中填写consumeSecret。
6.Instagram后台配置
打开Instagram开发者页面,注册账号并登陆。点击“Manage Clients”标签打开应用列表,点击“Register a New Client”新建一个客户端。
在新建客户端的页面填写相关信息提交即可完成创建。
回到“Manage Clients”页面,点击刚刚新建的客户端可以查看详情,在这里可以看到Client ID和Client Secret。
新建的客户端的状态是“Sandbox”,在这种状态下,所有参与测试的人员都需要添加到“Sandbox”才能参与测试,添加用户到“Sandbox”的方法如下:打开“Sandbox”标签页面,输入邀请的用户名,用户名不是邮箱,一般用户名是注册邮箱@符号的前部分。注意,添加后一定要保存才能生效。保存后通知被邀请人接受邀请,可在“Sandbox Invites”看到邀请记录,接受邀请后的用户可以测试登录。
应用如果完成了测试要准备上线,需要将应用发布为正式状态,在“permissions”标签下,点击“Start a submission”进行权限申请。
在下一步选择“My app allows people to login with Instagram and share their own content.”,填写相关信息,这一步需要一个视频演示链接,完成提交后等待审核即可。
7.智能客服 AIHelp后台配置
AiHelp官方支持地址:
https://aihelp.net/elva/FAQ/FAQList.aspx?l=zh_CN&SectionID=0&pf_app_id=5
AiHelp 官方后台配置文档地址(页面内有下载链接介绍文档pdf):
https://aihelp.net/elva/FAQ/FAQList.aspx?SectionID=3392&LanguageID=5&pf_app_id=5&kmContentId=122760
已下是常用功能配置说明,需更多更详细请到官方下载最新pdf文档
7.1.新建应用
7.1.1 左侧“设置”-> “应用”-> “+”如下图位置
弹出界面,输入应用名称,点击“Add”完成新建 如下图
7.1.2 选择新建应用,如下图操作
选择中刚刚新建应用,会切换到应用下内容。
7.2.获取参数
如果不在需要app下,需按照 7.1.2 切换app
左侧“设置”-> “应用”-> “+”如下图位置
7.3.添加语言
设置语言后app应用Aihelp部分功能支持多语言。
左侧“设置”-> “语言”-> “添加语言”如下图位置
点击设置后,弹出语言列表,可以增加需要语言
7.4.配置FAQ
此功能配置是在app 应用中FAQ相关功能
7.4.1.新建FAQ分类
左侧“机器人”->“常见问题”-> “[分类]”-> “新增分类+” 如下图位置
弹出新增页面,输入名称和顺序编号后保存
分类列表会出现新建分类,左侧栏也会出现对应分类
7.4.2编辑FAQ分类
在分类列表中,点击如下图按钮
弹出详情页面,可做对应修改。其中中文,英文对应aihelp sdk显示的语言内容。
7.4.3.新建FAQ
在左侧栏选择FAQ分类->“新增FAQ”,如下图
弹出新增页面
7.4.4.编辑FAQ
在FAQ列表中,点击如下图按钮
弹出详情页面,其中语言对应aihelp sdk显示的语言内容。
7.4.5.发布FAQ
如,在热门问题分类下,创建了一个信息,然后发布流程 左侧“机器人”-> “常见问题”-> “发布” 如下图位置
7.5.配置运营模块Tab
此功能是app应用中运营界面功能
7.5.1.新建Tab
左侧“运营支持”-> “运营模块”-> “[Tab设置]”-> “新增Tab” 如下图位置
弹出新增页面
7.5.2.编辑Tab
左侧“运营支持”-> “运营模块”-> “[Tab设置]”-> 编辑,如下图
7.5.3.新建文章
左侧“运营支持”-> “运营模块”-> “[Tab列表]”,选择刚才创建的tab1,点击新建,如下图
弹出新增页面
7.5.4.编辑文章
在文章列表中,点击如下按钮
弹出详情页面,其中语言对应aihelp sdk显示的语言内容。
7.5.5.发布Tab
Tab要在app应用中显示需要发布,每次修改都需要发布。
左部“运营支撑”-> “运营模块”-> 需要发布的Tab -> “发布” 如下图位置
选择平台、语言后发布
发布后,效果图如下
7.6 自定义SDK配置
7.6.1 展示头像配置
7.6.2 APP对外名称配置
7.6.3 更多其他配置
另外还包含欢迎语设置,主题设置等等功能。
详情请参考:
https://aihelp.net/FAQ/#/AIhelp%20Support/app/zh_CN/EB5AE263D8AB85A4/35E3B9E6396692FE/396CD31FF6A33A5D
8.华为HMS后台配置
8.1 基本流程
1、登录流程
参考:https://developer.huawei.com/consumer/cn/doc/development/HMSCore-Guides/dev-process-0000001050443773
2、支付流程
参考:https://developer.huawei.com/consumer/cn/doc/development/HMSCore-Guides/dev-process-0000001050033070
8.2 配置AppGallery Connect
1)注册成为开发者
2)在 AppGallery Connect创建项目、创建应用
A、 如果没有项目,则创建项目,我的项目—添加项目,输入项目名称,确认,则项目创建成功。
点击确定完成后,点击添加应用,跳转添加应用界面
注:需要集成支付能力,包名后缀必须为.HUAWEI或者.huawei
B、如果已存在项目,则可在项目下,创建具体的应用,一个项目下可创建多个应用
3)生成签名证书指纹
keytool -list -v -keystore C:\TestApp.jks
执行结果如下:
说明:C:\TestApp.jks表示应用签名文件,CP替换成自己的签名文件即可。
4)在“我的项目”中找到刚创建的项目项目,找到对应的应用,配置SHA256证书,如下图所示
5)打开相关服务
5.1)打开API权限服务,在“项目设置”->“API管理”菜单中,开启相应服务,如下图所示:
登录服务为 Auth Service,支付服务为 In-App Purchases,其他权限为创建应用默认开启的权限,可以忽略。
此操作为项目级别操作,操作完后,项目下所有应用都会有此权限。
5.2)配置支付参数
① 在我的项目中,选择具体某个应用,在左侧导航栏选择“盈利 > 应用内支付服务”,点击“设置”。
说明:如果首次配置会弹出签署协议弹框,其中订阅通知地址,可不填写
8.3.获取应用的AppGallery Connect配置文件
1)获取agconnect-services.json文件
8.4.配置商品
1)打开“ AppGallery Connect”->“我的应用”->“运营”菜单,如下:
2)点击“添加商品”,如下图所示:
填写商品相关的商品信息,点击保存即可,这里选择“消耗型”商品。
3)创建商品后,默认状态为失效状态,需要点击激活按钮:
点击后,提示此商品将被开放购买,点击确认。
8.5.配置沙盒测试账号
参考:https://developer.huawei.com/consumer/cn/doc/distribution/app/agc-tester_account_mgt
接入完支付sdk后,华为提供沙盒支付测试模式。打开华为AppGallery Connect管理后台,选择用户与访问,选择左侧沙盒测试栏目下的测试账号,点击新增,输入华为账号即可
注:测试帐号必须填写已注册、真实的华为帐号。
添加完成后,使用此沙盒测试账号,支付时,可以直接进行沙盒支付测试
8.6.配置华为分析
1)接入流程
2)后台开启分析服务
a、如果没有华为开发者联盟帐号,需要先注册帐号并通过实名认证。详细操作请参见帐号注册认证。
b、参见创建项目和在项目中添加应用完成应用的创建。
c、登录AppGallery Connect网站,点击“我的项目”图标
d、选择需要查看分析数据的应用。
e、点击“华为分析”下的任意菜单,并点击“启动分析服务”按钮可开通分析服务。(注:需拥有产品管理权限才可开通服务)
f、进入“项目接入设置”页面,设置数据存储位置、数据共享设置、支持行业分析、标识用户、时区、货币、设置用户数据留存时间、设置自然周定义后,点击“完成”,即完成Analytics Kit 服务开通。对于支持行业分析,如果您已经设置应用的分类情况,则默认开启
g、开启后,选择项目设置–我的项目–应用,下载最新的配置文件,给到研发进行更新
3)调试
1、开启/停用调试模式
1 2 |
adb shell setprop debug.huawei.hms.analytics.app package_name |
调试模式打开后,所有事件将实时上报,在应用调试界面可实时查看上报的数据。
说明:请将命令行中的“package_name”字段替换为您的应用包名
数据成功上报后,“华为分析 > 应用调试”页面会展示出数据,如下图
2、您可执行如下命令行,停用调试模式
1 2 |
adb shell setprop debug.huawei.hms.analytics.app .none. |
8.7.开通华为性能分析
参考:https://developer.huawei.com/consumer/cn/doc/development/AppGallery-connect-Guides/agc-apms-viewdata
进入“质量->性能管理”,如果APM服务未开通,请点击“立即开通”按钮,开通APM服务
说明:
由于开通服务时可能需要设置数据存储位置,设置数据存储位置后会刷新agconnect-services.json文件里的配置。如果您开通服务时设置了数据存储位置,在开通完成后您需要重新下载agconnect-services.json文件并集成到您的工程中。