Mac App 公证的新功能

公证和 macOS 的组合可帮助用户通过非 App Store 渠道为其 Mac 安全下载软件。了解从 altool 到 notarytool 所需的过渡，以及 Xcode GUI 可以如何帮助您在对 App 进行公证时改善整体性能。我们还将分享有关 API 的信息，以便和任何联网设备的公证服务关联。

资源

相关视频

WWDC23

WWDC22

了解开发者模式

WWDC21

WWDC19

公证面面观

下载

♪ 柔和乐器演奏的嘻哈音乐 ♪ ♪ 大家好我是 Johnathan macOS 开发人员将软件提交给公证服务以帮助保护他们的客户免受恶意软件的侵害去年我们推出了一种更快更简单的方式通过 notarytool CLI (命令行界面) 提交 App 进行公证今年我们很高兴能通过为您与公证服务的交互做出的一些重大改进继续优化性能和灵活性在本讲座中我们将讨论三个主要的主题首先我们将了解从使用 altool 转换为使用 notarytool 进行公证的重要截止日期接下来我们将讨论即将推出的 Xcode 14 对 Xcode 集成所做的改进这为 Xcode 带来了 notarytool 的提交速度最后我们将讨论一种灵活的与公证服务交互的新方式即 REST API 它让您可以在更多地方进行上传查看提交状态并检查提交内容

去年我们推出了 notarytool 这是一个替代 altool 进行公证的工具在本讲座的稍后部分我将讨论 Xcode 通过 Xcode 14 迁移到我们最新的后端为通过 altool 和 Xcode 13 进行的公证准备好迁移路径之后我们宣布使用这些旧方法进行公证的截止日期是 2023 年秋季如果您从 altool 迁移到 notarytool 时需要帮助请参考去年的讲座 “更快更简单的 Mac App公证方式” 这里还有一些细节要说明包括捆绑在 Xcode 13 中的 notarytool CLI 在 2023 年秋季的截止日期之后还能继续工作不过与往常一样我们鼓励您进行更新以接收最新的改进和修补程序但我们将在该截止日期后停止支持使用 Xcode 13 UI 上传到公证服务请继续关注 Xcode 14 中的一些性能改进但在很大程度上您可以预期您的工作流程不会改变最后所有形式的 altool 公证将在 2023 年秋季停止工作有关迁移到 notarytool 的详细信息也请参考去年的 WWDC 讲座接下来我们将谈谈 Xcode 14 中公证方式的变化我们已经迁移了 Xcode 中内置的公证支持功能以使用与我们去年推出的 notarytool CLI 相同的可靠后端因此我们很高兴为 Xcode 14 带来大约 4 倍的性能提升这与我们去年针对 notarytool 宣布的性能提升是一致的最棒的是除了更新您无需更改项目设置或工作流程即可获得这种性能提升对于本讲座的最后一个主题我们很高兴地宣布一项新服务 Notary REST API 这项新服务让您可以在更多地方更灵活地与公证服务进行交互我们看一下几个重要的概念这个新的 API 旨在为公证服务提供更灵活的界面作为基于 JSON 的 Web 服务集成在大多数语言里应该相当简单此 API 允许您从任何有网络连接的地方上传提交文件包括持续集成服务器在这些地方您目前可能没有运行 macOS 此外该 API 还支持与公证服务的其他交互例如检索您的提交历史记录或过去的提交详情我们引入 REST API 的目标是支持从更多平台提交软件进行公证并允许在自动化系统中更轻松地与公证人进行交互提供了当前的提交方法 Xcode 和 notarytool 之外的补充方式可用于这些方法目前无法运行的地方比如基于 Linux 的持续集成举个例子假设您希望部署管道在分发之前将您的 App 提交给公证人通过这个新的 API 和一些基本的脚本您可以轻松地实现该过程的自动化在我开始正题之前一个重要的主题是身份验证您可以通过像其他 App Store Connect API 一样使用 JSON Web Tokens 或 JWT 的 API 进行身份验证有关身份验证或我将要展示的代码的更多详细信息请访问下面链接的 REST API 文档在这些代码片段中我假设您将有效的 JWT 作为令牌变量传递给函数我们来看一个在 Python 中向公证人提交文件的例子其他编程语言也适用同样的基本流程将文件上传给公证人有两个主要步骤第一步是通知公证人您希望上传文件其中包含有关该文件的一些基本信息如文件名和 SHA-256 响应包含上传文件所需的信息和通过我们的管道跟踪提交文件的 ID 第二步是通过 Amazon S3 实际上传文件进行公证您需要利用您最喜欢的 S3 SDK 对于这个例子我将使用 boto3 库在这里我们使用上一次调用中返回的临时凭证进行身份验证并创建客户端然后我们使用客户端将文件上传到第一步的响应中指定的存储桶和对象上传后提交文件将通过公证管道处理对于大多数提交文件此过程应在 15 分钟内完成上传后您应在分发前确认公证服务已成功处理您提交的文件从广义上讲有两种方法可以做到这一点第一种方法也是最简单的方法是通过相同的 API 来检查结果另一种选择是借助于随 notarytool 引入的 webhook 支持首先我们看一下 API 方法查看向公证人提交的文件的状态非常简单您可以使用在上传过程中收到的提交 ID 提出请求响应包含提交文件的当前状态该状态将一直为“进行中” 直到公证人完成处理然后该状态将转换为提交文件的最终状态例如已接受或无效提交完成后您可以使用该 API 来检索此次上传的公证日志有关这些端点的更多详情请参阅 Notary REST API 文档接下来我们将讨论获取状态的第二种方法：webhook 在 webhook 工作流程中过程大致相同但这次您将在初始上传请求中提供 webhook URL 有关格式的详细信息请参阅 Notary REST API 文档和以前一样这将触发公证服务来分析您提交的文件当自动分析结束时会创建工单并保存最终状态完成后公证服务将调用提供的 webhook URL 此调用的内容包括提交 ID 团队 ID 和证明其来自我们的签名收到该通知后您可以选择下一步做什么例如您可以通知原始提交者或启动自动分发管道与使用 notarytool 等待相比这允许您将上传文件的系统与公证后自动执行操作的系统分离我们很高兴看到这个新的 REST API 打开了与持续集成系统和其他为 macOS 构建软件的工具进行更多集成的大门在本讲座即将结束时再次提醒一下转换为使用 Xcode 14、notarytool 或直接使用 REST API 的截止日期是 2023 年秋季最后如果您还不能在部署管道中使用 notarytool 现在试用 Notary REST API 将为您带来启动自动化的机会您可以在下面找到文档链接谢谢我希望您喜欢 WWDC 22 的其余部分 ♪

4:53 - REST API: upload file for notarization

# Upload file for notarization

def upload_file(token, filepath, sha256):
    data = { "sha256": sha256, "submissionName": os.path.basename(filepath) }
    resp = requests.post(
       "https://appstoreconnect.apple.com/notary/v2/submissions",
        json=data,
        headers={"Authorization": "Bearer " + token})

    output = resp.json()
    aws_info = output["data"]["attributes"]
    submission_id = output["data"]["id"] 

    client = boto3.client(
        "s3",  
        aws_access_key_id=aws_info["awsAccessKeyId"],
        aws_secret_access_key=aws_info["awsSecretAccessKey"],
        aws_session_token=aws_info["awsSessionToken"])
    client.upload_file(filepath, aws_info["bucket"], aws_info["object"])

6:12 - REST API: wait for completion

# Wait for completion

def watch_upload(submission_id, token):
    while True:
        resp = requests.get(
            "https://appstoreconnect.apple.com/notary/v2/submissions/" + submission_id, 
            headers={"Authorization": "Bearer " + token})

        output = resp.json()
        current_status = output["data"]["attributes"]["status"]
        
        if current_status != "In Progress":
            return current_status # For example: Accepted or Invalid

        time.sleep(30) # Allow time for submission to progress

正在查找特定内容？在上方输入一个主题，就能直接跳转到相应的精彩内容。