uni-app iOS 苹果授权登录（Sign in with Apple）/Apple登录/苹果登录集成教程

uni-app iOS 苹果授权登录（Sign in with Apple）/Apple登录/苹果登录集成教程

此文档将不再维护，请参考新文档：苹果登录

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 服务并保存

苹果开发者后台设置

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

重新编辑profile文件

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

HBuilderX配置苹果登录

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

登录按钮样式

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

需要注意的是：

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

下面是原生端默认的几种按钮样式供大家参考（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

属性 类型 说明
user String 苹果用户唯一标识符
state String 验证信息状态
email String 用户共享的可选电子邮件
fullName Object 用户共享的可选全名
authorizationCode String 验证数据
identityToken String Web令牌(JWT)
realUserStatus Number 标识用户是否为真实的人 0：当前平台不支持，忽略该值；1：无法确认；2：用户真实性非常高
scope String 返回信息作用域

fullName

属性 类型 说明
namePrefix String 名字前缀，头衔、敬称
givenName String 名字
middleName String 中间名
familyName String 姓
nameSuffix String 名字后缀，学位、荣誉
nickName String 昵称

授权失败 code 说明

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

注意事项

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

更多关于uni-app iOS 苹果授权登录（Sign in with Apple）/Apple登录/苹果登录集成教程的实战教程也可以访问 https://www.itying.com/category-93-b0.html

1 回复

更多关于uni-app iOS 苹果授权登录（Sign in with Apple）/Apple登录/苹果登录集成教程的实战教程也可以访问 https://www.itying.com/category-93-b0.html


在uni-app中实现iOS苹果授权登录（Sign in with Apple），你需要结合uni-app的原生插件机制以及Apple的AuthenticationServices框架。以下是一个基本的实现思路和代码案例，帮助你集成苹果登录功能。

1. 准备工作

确保你的uni-app项目已经配置好iOS原生开发环境，并且有一个有效的Apple Developer账号。

2. 创建原生插件

在uni-app项目的根目录下创建一个nativeplugins文件夹，并在其中创建一个新的插件目录，例如apple-auth。

2.1. iOS原生代码

在apple-auth目录下创建一个AppleAuth.m文件，并添加以下代码：

#import <Foundation/Foundation.h>
#import <AuthenticationServices/AuthenticationServices.h>

@interface AppleAuth : NSObject

+ (void)requestAppleAuthWithCompletion:(void (^)(NSString *user, NSError *error))completion;

@end

@implementation AppleAuth

+ (void)requestAppleAuthWithCompletion:(void (^)(NSString *user, NSError *error))completion {
    ASAuthorizationAppleIDProvider *provider = [[ASAuthorizationAppleIDProvider alloc] init];
    ASAuthorizationAppleIDRequest *request = [provider createRequest];
    request.requestedScopes = @[ASAuthorizationScopeFullName, ASAuthorizationScopeEmail];

    ASAuthorizationController *authorizationController = [[ASAuthorizationController alloc] initWithAuthorizationRequests:@[request]];
    authorizationController.delegate = self;
    authorizationController.presentationContextProvider = self;
    [authorizationController performRequestsAndHandleResponse:^(ASAuthorizationController *controller, ASAuthorizationResponse *response, NSError *error) {
        if (error) {
            completion(nil, error);
        } else if ([response isKindOfClass:[ASAuthorizationAppleIDCredentialResponse class]]) {
            ASAuthorizationAppleIDCredential *credential = response.credential;
            NSString *userIdentifier = credential.user;
            completion(userIdentifier, nil);
        }
    }];
}

@end

2.2. 配置插件

在apple-auth目录下创建一个manifest.json文件，配置插件的基本信息。

{
    "id": "apple-auth",
    "version": "1.0.0",
    "name": "Apple Auth",
    "description": "Apple Sign In integration for uni-app",
    "platforms": ["ios"]
}

3. 在uni-app中使用插件

在你的uni-app项目中，通过plus.nativeObj.invoke方法调用原生插件。

plus.nativeObj.invoke('apple-auth', 'requestAppleAuthWithCompletion', [], (event) => {
    if (event.success) {
        console.log('Apple user ID:', event.result);
    } else {
        console.error('Apple login failed:', event.error);
    }
});

注意事项

  1. 确保你的App ID在Apple Developer后台启用了Sign in with Apple功能。
  2. 在Xcode中配置好Sign in with Apple的权限和Capabilities。
  3. 由于涉及到用户隐私，确保你的应用符合Apple的隐私政策。

以上代码提供了一个基本的集成框架，你可能需要根据具体需求进行进一步的调整和优化。

回到顶部