iOS 苹果授权登录(Sign in with Apple)/Apple登录/苹果登录集成教程

news/2024/10/19 2:26:07/

链接

HBuilderX 自 2.4.7+ 版本开始支持 Sign in with Apple (苹果登录),苹果登录是 iOS13 新增加的功能,当你的应用使用了第三方登录比如微信登录,同时也需要集成苹果登录,否则提交AppStore审核会被拒绝。

根据苹果审核指南要求,如果 app 使用第三方或社交登录服务 (例如,Facebook 登录、Google 登录、通过 Twitter 登录、通过 LinkedIn 登录、通过 Amazon 登录或微信登录) 来对其进行设置或验证这个 app 的用户主帐户,则该 app 必须同时提供“通过 Apple 登录”作为同等选项。详情参考:App Store 审核指南 - 通过 Apple 登录

使用苹果登录的教程

使用苹果登录首先需要在苹果开发者后台开启 App 的 Sign In with Apple 服务

注:只有发布Appstore的应用才能使用苹果登录。企业版开发者账号不支持 Sign In with Apple (企业版开发者账号指的是用于企业内部分发App,不能用于发布 App Store 的账号,也就是价格为 299$ 的账号)

1.登录到苹果开发者后台 编辑对应的 Identifier 勾选 Sign In with Apple 服务并保存

 

2.勾选或取消服务,会导致之前的 profile 描述文件失效,不需要新建,只要点击 Edit 重新编辑对应的 profile文件,然后保存下载使用新的profile文件即可

 

在 HBuilderX 编辑项目的 manifest.json ,在 App SDK配置中找到苹果登录,并勾选。

 

 

测试苹果登录服务,需要提交云打包或提交自定义基座打包,只有添加了苹果登录服务提交打包才会将苹果登录模块打进安装包,否则调不到相关方法

登录按钮样式

苹果对登录按钮样式有要求,请按照苹果要求统一设置登录按钮的样式,否则审核可能会被拒绝

需要注意的是:

  • 按钮必须在显著的位置(避免滑动屏幕才能看到)
  • 登录按钮有三种外观:白色,带有黑色轮廓线的白色和黑色,其他设计可能会影响审核;
  • 按钮圆角范围及按钮最小尺寸也有要求;
  • 具体规则请参考苹果 官方文档

下面是原生端默认的几种按钮样式供大家参考(width:130pt, height:30pt, corner radius: 6pt)

 

 

示例代码 (详细 api 请查阅 plus.oauth 文档)

注:因为是 iOS13+ 系统才支持苹果登录,所以建议在App的界面入口判断下,只有 iOS13 才显示Apple登录的选项

uni-app示例

复制代码uni.login({  provider: 'apple',  success: function (loginRes) {  // 登录成功  uni.getUserInfo({  provider: 'apple',  success() {  // 获取用户信息成功  }  })  },  fail: function (err) {  // 登录失败  }  
});  

5+App示例 (可以在 uniapp 中直接调用5+API)

注:因为是 iOS13+ 系统才支持苹果登录,所以在 iOS13 以下设备调用 plus.oauth.getServices 不会返回苹果登录对应的 service 对象

复制代码var appleOauth = null;  
plus.oauth.getServices(function(services) {  for (var i in services) {  var service = services[i];  // 获取苹果授权登录对象,苹果授权登录id 为 'apple' iOS13以下系统,不会返回苹果登录对应的 service    if (service.id == 'apple') {  appleOauth = service;  break;  }  }  appleOauth.login( function(oauth){  // 授权成功,苹果授权返回的信息在 oauth.target.appleInfo 中    }, function(err) {  // 授权失败 error  }, {  // 默认只会请求用户名字信息,如需请求用户邮箱信息,需要设置 scope: 'email'    scope: 'email'  })  
}, function(err) {  // 获取 services 失败  
})

5+ api 返回参数说明

注意:这里是 5+ api 返回的数据,uni 接口对 5+api 做了封装,以实际返回结果为准

appleInfo

属性类型说明
userString苹果用户唯一标识符
stateString验证信息状态
emailString用户共享的可选电子邮件
fullNameObject用户共享的可选全名
authorizationCodeString验证数据
identityTokenStringWeb令牌(JWT)
realUserStatusNumber标识用户是否为真实的人 0:当前平台不支持,忽略该值;1:无法确认;2:用户真实性非常高
scopeString返回信息作用域

fullName

属性类型说明
namePrefixString名字前缀,头衔、敬称
givenNameString名字
middleNameString中间名
familyNameString
nameSuffixString名字后缀,学位、荣誉
nickNameString昵称

授权失败 code 说明

code说明
1000未知错误
1001取消授权
1002返回值无效
1003请求未处理
1004授权失败

最后提交云打包或自定义基座打包进行功能测试

注意事项

  1. 只有首次弹出登录授权框时才会有用户名及email的项(email需要配置 scope: 'email' ),并且用户可以删除或编辑用户名或隐藏用户邮箱,如果用户删除了用户名授权成功后fullname字段也会为空;
  2. 授权成功后再次调用登录接口会先校验上次授权是否依然有效,如有效,直接回调成功并返回上次授权成功时的数据,注意,此校验不会校验identityToken是否过期,需要用户自行处理;如果想每次都弹出授权框获取新的identityToken等信息,需要先调用'logout()',然后在调用登录接口就会弹出授权框,注意这时授权框内不会在出现用户名及邮箱,登录成功后这两个字段会为空,需要拿到 authorizationCode,identityToken 后传给服务器,然后和苹果服务器验证可获取用户名称等信息,具体请自行查阅文档;如果想在授权框中再次出现用户名或邮箱。需要在 系统设置->AppleID->密码与安全性->使用Apple ID 的 App 里面取消授权,然后再调用登录接口;

http://www.ppmy.cn/news/338864.html

相关文章

Apple苹果公司组织架构

Apple苹果公司组织架构 这种模式,自乔布斯回到苹果时,开始实施,一直保留到现在。 今天,苹果大学校长兼副总裁 Joel Podolny 在《哈佛商业评论》上发表了一篇题为《How Apple is Organized for Innovation》的文章,深…

iPhone历代产品,从3GS到7Plus详尽参数

iPhone 7 Plus iPhone 7 iPhone SE iPhone 6s Plus iPhone 6s iPhone 6 Plus iPhone 6 iPhone 5S iPhone 5C iPhone 5 iPhone 4S iPhone 4 iPhone 3GS 图片展示 机身高度 158.2 mm 138.3 mm 123.8 mm 158.2 mm 138.3 mm 158.1 mm 138…

苹果8参数_iPhone11 iPhone11Pro哪里买最便宜靠谱划算 2020双十一苹果手机购机攻略...

主要配置参数。 iPhone11系列机型配置参数 正品购买渠道。 哪里在保证正品的前提下,又能享受到这么划算的价格呢? Apple产品京东自营旗舰店: 正品保证价格便宜收货快(当日或次日达)还能享受京东和苹果官方的双重售后保…

设置苹果机参数

其中 【newCommandTimeout】是 查找某个页面的元素时,定位可能会时间超长。默认的命令间隔时间是60s,如果在60s内没有找到,就会自动退出 自己成功启动过的头部 # -*- coding: utf-8 -*- from time import sleepfrom appium import webdriverfrom seleniu…

樱桃键盘 Cherry 键盘 windows键 无效 没反应

FUNF9解锁,这是为了防止误触把几个键给锁定了。

CHERRY樱桃机械键盘按键

FNF1:静音 FNF2:音量减少 FNF3:音量增大 FNF4:灯光开关 FNF5:灯光亮度调节 FNF6:灯光亮度调节 FNF7:灯光速度调节 FNF8:灯光速度调节 FNF8:锁定键盘中的窗口键 FNF10&…

84键键盘没有insert键

84键键盘,insert和delete使用了同一键位,使用 fndel 可打出insert

ikbcF108键盘重置

Fnr, 按住5秒,期间键盘指示灯会闪,复位成功