背景故事

前两天,本来一个运行正常、打包测试都没问题的XCode工程突然爆出各种奇怪的Entitlement错误:

  • 什么签名的内容跟配置文件的不一致。

又或者

  • 无法安装,因为签名或者配置文件的配置错误。

折腾了大半天时间以后,只发现一个地方,苹果的开发者证书被某同学重置了……虽然一再强调要小心,不要随便点确定,但是,这种事情还是无法完全避免。我对那些不看信息提示的同学已经是无语了。

然而,尽管我把证书重新生成,并更新了所有相关的配置文件(provisioning profile),却还是各种莫名其妙的错误。

最后,我放弃了,找了一个专业做iOS开发的同学来帮忙,他指出:

XCode的缓存有问题,有时候修改配置并不会生效。

在他的指导下,经过删除账号信息->重启XCode->重新登录->删除配置文件->重启XCode->重新下载配置文件->重新配置签名。也不知道重启了多少次XCode,总之,在所有错误消失的那一刻,我才长长松了一口气:CAO~~~~~~~~~~~

老实说,XCode一切都好,就是这些签名文件的管理实在是有点反人类,跟itunes一样,你好像永远都无法理解它的逻辑。

随后,我又google了一下我遇到的那个Entitlement错误,果然找到了一篇苹果官方的文章《Entitlement问题定位指南》:

https://developer.apple.com/library/ios/technotes/tn2415/_index.html

本着“知其然,知其所以然”的精神,通读了几遍,终于对XCode管理配置文件的原理,有了稍微清晰一点的概念。以下是一些笔记:

什么是Entitlement?

Entitlement(权限),可以想象成App里用于描述该App可以调用哪些服务的字符串。苹果的操作系统(mac os或者iOS)会通过检查这个串,决定这个应用是否可以调用相关功能。比如iCloud权限,推送服务,健康服务等。

常见的Entitlement错误

  • 编译打包时

The executable was signed with invalid entitlements. The entitlements specified in your application's Code Signing Entitlements file do not match those specified in your provisioning profile.
  • 安装时

Could not install the application. Your code signing/provisioning profiles are not correctly configured ... you have an entitlement not supported by your current provisioning profile ... (error: 0xe8008016).
  • 提交到苹果商店时

Invalid Code Signing Entitlements. The entitlements in your app bundle signature do not match the ones that are contained in the provisioning profile. According to the provisioning profile, the bundle contains a key value that is not allowed: '[A1B2C3D4E5.com.appleseedinc.MyGreatApp ]' for the key "keychain-access-groups" in "Payload/MyGreatApp.app/MyGreatApp"
  • 错误的值

entitlement 'keychain-access-groups' has value not permitted by a provisioning profile

查错流程

下图是遇到Entitlement错误时,完整的检查流程:

注意: PP = Provisioning Profile 配置文件

  1. 在Xcode里设置目标应用的功能 (Target Capabilities)

  2. 苹果开发者用户中心网站的 App ID服务

  3. 通过网站(与2相同)创建Provisioning Profile (预配置文件)

  4. 网站的预配置文件库

  5. 检查Provisioning Profile里的权限设置

  6. 把Provisioning Profile安装到Xcode里

  7. Xcode的本地Provisioning Profile文件库

  8. 在Xcode里配置使用哪个Provisioning Profile文件

  9. 在编译日志里检查哪个Provisioning Profile被使用

  10. 检查打包好的应用里包含的权限

  11. 操作系统在安装或者启动时对App进行权限检查

第一步

Entitlement的产生,也就是一个App需要包含哪些权限,可以通过Xcode自动设置也可以自己到开发者网站上设置。

通过Xcode -> project -> Target -> Capabilities 开启或者关闭指定功能

理论上,点了"Fix Issues",Xcode会自动做以下事情:

    1. 更新权限需求

    2. 注册App ID

    3. 为该App ID开启或者关闭相关服务

    4. 创建或者更新Provisioning Profile

    5. 下载并安装该Provisioning Profile文件,因为后边对应用进行签名的时候需要用。

如果网络和运气都好,那么就什么事都没有了。

手动操作

但是,由于苹果网站和中国网络的问题,可能不会那么顺利。如果Xcode没法自动完成任务,那就需要手动进行相关操作:

  • 创建App ID,并开启服务

有些服务会需要额外的信息,比如推送服务,需要指定证书。

  • 添加Provisioning Profile

  • 检查Provisiong Profile包含的服务内容

  • 检查本地的Profile是否包含所需要的权限

security cms -D -i /path/to/iOSTeamProfile.mobileprovision
  • 安装Profile到Xcode

如果是从网站上下载的.mobileprovision,双击该文件将自动安装到Xcode指定的位置。

  • 检查Xcode本地Provisioning Profile文件库

Xcode > Preferences > Accounts > (your account) > View Details

注意,这个是旧版的了,最新的7.3版本略有不同。其中最大的不同是,刷新按钮不见了!!取而代之的是“Download All”按钮,大概是这样子:

在Action一栏,如果这个文件不在本地,会有“Download”下载按钮,如果已经下载到本地了,就没有了。

右键点已经下载的文件,有2个选项:

1. 在Finder里显示

2. 删除 (然后就可以重新下载了)

  • 在Xcode里设置Provisioning Profile文件

如果所需要的Provisioning Profile文件都已经下载到本地,可以考虑让Xcode自动选择,具体的配置方法,参考苹果的另外一个文档:https://developer.apple.com/library/mac/qa/qa1814/_index.html

配置成功后,应该是这样子:

当然,你也可以手动指定签名标识(Code Signing Identity),和Provisioning Profile。

特别值得一提的是:如果Provisioning Profile文件没问题,当你指定了一个Profile以后,Code Sigining Identity的下拉列表里会提示这个Profile所属的开发者账号。

如果没有,则说明这个文件有问题或者Xcode有问题。

(这也是我那个专业同事介绍的办法,实测非常有用。)

到这一步,都正确的话,应该就没问题了。

后边是一些额外的检查:

  • 查看编译日志

编译顺利的话,日志里会提示用到哪个Profile文件:

  • 检查编译出来的App是否包含正确的权限

命令行:

$ codesign -d --ent :- /path/to/the.app

有几个细节:

a. 在对App进行签名的时候,相关的服务权限就被从Profile文件里转移到应用本身的签名里了。

b. Profile也会被内置到App里。如果打开App包查看,可以看到 embedded.mobileprovision

  • 操作系统对App进行检查权限

操作系统的检查,就是基于刚刚说的两个地方:应用自身的签名,内置的Profile。当二者不一致时,就会报错。除了权限外,操作系统还会检查App ID是否一致。

  • 提交到苹果商店前检查权限设置

这是整个流程的最后一个可以检查权限是否错误的地方

其他

  • 手动添加Entitlement文件

通常,Xcode会自动管理Entitlement文件,所以我们并不需要在Xcode Project的Buidling Settings -> Code Signing -> Code Signing Entitlements 特意设置文件。

旧版本的Xcode,你需要自己添加Entitlement文件:

.entitlements文件的格式(应该也是.plist格式)

  • Entitlement常见字段介绍

    • beta-reports-active  是否可以通过TestFilight发布

    • team-identifier 开发账号的团队id,由10个数字和字母字符组成。这个值也是默认的App ID前缀。

    • get-task-allow Xcode是否可以对该应用进行调试。

    • application-identifier 应用的App ID,格式是 <prefix>.<bundle_id>

    • keychain-access-groups 钥匙串权限组 (更多可以参考 https://developer.apple.com/library/ios/documentation/Security/Reference/keychainservices/)

    • push-notification 开启推送服务后,会有这个字段,它的值表示是生产环境(production)还是开发环境(development)。

  • App ID 前缀检查

操作系统还会对App ID的前缀(也就是团队id)进行检查,如果发现App签名里的前缀和profile文件里不一致,也会报错。

App ID前缀的相关参考:

  • App ID前缀不一致错误: https://developer.apple.com/library/ios/qa/qa1879/_index.html

  • 管理多个App ID前缀: https://developer.apple.com/library/ios/technotes/tn2311/_index.html

  • 钥匙串访问警告: https://developer.apple.com/library/ios/qa/qa1726/_index.html

  • 升级App时提示App ID与当前安装的App不一致:https://developer.apple.com/library/ios/technotes/tn2319/_index.html#//apple_ref/doc/uid/DTS40013778-CH1-ERRORMESSAGES-UPGRADE_S_APPLICATION_IDENTIFIER_DOES_NOT_MATCH_THE_INSTALLED_APP

Xcode entitlement 问题定位和解决指南的更多相关文章

  1. [iOS 开发] Xcode常见报错及解决办法

    报错一: 在iOS7的真机运行时,弹出错误:App installation failed. There was an internal API error. 如图 解决办法: 在Xcode -> ...

  2. Xcode常见报错及解决办法

    报错一: 在iOS7的真机运行时,弹出错误:App installation failed. There was an internal API error. 如图 解决办法: 在Xcode -> ...

  3. centos7.5离线安装Docker及容器运行报OCI runtime create failed 问题定位与解决

    前言 接上篇 <记一次centos挂载ceph存储的坑> 服务器重做了centos7.5版本的操作系统,剩下就是安装docker,考虑yum安装耗时较长,我一般都是直接安装二进制版本doc ...

  4. invalid code signing entitlement的通用暴力解决办法

    1.添加的一台苹果设备为开发机子后,打版本,说profile 没找到,报错 2.上传二进制文件到itunes connect ,报错 3.有时候还什么 appID 无效,报错 烦死他了 我的解决办法, ...

  5. xcode8 使用Instruments检测定位并解决iOS内存泄露

    https://www.jianshu.com/p/9bc7e65fc247 2017.07.27 17:24* 字数 628 阅读 1319评论 6喜欢 21 简介: 虽然苹果出了ARC(自动内存管 ...

  6. (高德地图)marker定位 bug 解决总结

    项目背景: 一个项目bug,项目中用到高德地图,默认打开页面会生成一个marker(下图红色icon),然后用户拖动marker到想要的位置,并且保存. 用户反映定位不准确,在当前页面编辑的位置,到后 ...

  7. Xcode 7安装KSImageNamed失败解决方法

    ## How do I use it? Build the KSImageNamed target in the Xcode project and the plug-in will automati ...

  8. "The request sent by the client was syntactically incorrect ()"问题定位及解决:

    Spring MVC "The request sent by the client was syntactically incorrect ()"解决办法: 把spring日志级 ...

  9. SQL SERVER——CPU问题定位与解决

        CPU问题定位基本流程: 性能计数器诊断 主要用到的性能计数器 %Process Time 全实例 (主要用于查看当前服务器的CPU 情况) %Process Time sqlservr (主 ...

随机推荐

  1. 域控制器中的FSMO角色

    FSMO是Flexible single master operation的缩写,意思就是灵活单主机操作.营运主机(Operation Masters,又称为Flexible Single Maste ...

  2. Visual Assist 生成注释功能

    在Visual Studio环境中编码,Visual Assist是不可缺少的好工具.这工具功能非常强大,以前仅仅用到了代码提示,今天学习了生成注释功能,非常爽. 在代码编辑器中点击右键弹出菜单,在“ ...

  3. 在Huawei USG2100 上配置通过Huawei VPN客户端的接入

    USG2100 设置 一.本地策略 中允许 Untrust 对 L2TP 的访问: 二.勾选 VPN-->L2TP 启用: 三.设置参数: 1.组类型选择LNS,本端隧道名称LNS,对端隧道名称 ...

  4. 最大流问题Ford-Fulkerson方法(转)

    本篇主要讲解最大流问题的Ford-Fulkerson解法.可是说这是一种方法,而不是算法,因为它包含具有不同运行时间的几种实现.该方法依赖于三种重要思想:残留网络,增广路径和割.本文将会详细介绍这些内 ...

  5. PUA

    约会技巧 kino技巧 被拒绝的应对方法 (1)一般约会7个小时后,就能带女生回家 (2)点菜时多点一点,以回家放菜为名 (3)理由要文雅 (4)开酒店的理由 第一时间触碰测试 (1)第一次约会要第一 ...

  6. FlashBuilder(FB/eclipse) 打开多个无效

    FB也即Eclipse. 想要打开多个FB,只需要新建多个FB的快捷方式,然后在路径上面加上参数 -data "具体路径" 再打开即可. 如: "C:\Program F ...

  7. C和C++混合编程

    extern "C"表示编译生成的内部符号名使用C约定.C++支持函数重载,而C不支持,两者的编译规则也不一样.函数被C++编译后在符号库中的名字与C语言的不 同.例如,假设某个函 ...

  8. 使用SparkSQL实现多线程分页查询并写入文件

    一.由于具有多张宽表且字段较多,每个宽表数据大概为4000万条,根据业务逻辑拼接别名,并每张宽表的固定字段进行left join 拼接SQL.这样就能根据每个宽表的主列,根据每个宽表的不同字段关联出一 ...

  9. PLSQL_PLSQL Hint用法总结(概念)

    2014-06-20 Created By BaoXinjian

  10. OAF_EO系列4 - Create详解和实现(案例)

    2014-06-02 Created By BaoXinjian