跳到正文
苹果签知 苹果签名名词词典

描述文件

miáo shù wén jiàn

Provisioning Profile

名词 · 文件

描述文件是什么?Provisioning Profile 的定义、位置和查看方法

释义
Apple 开发者网站签发的授权文件,写明谁能签名、签哪个应用、装到哪些设备、何时到期、能用哪些权限。
出处
开发者账户的 Profiles 栏;电脑上的 .mobileprovision 文件;安装包里的 embedded.mobileprovision。
辨析
不同于 iPhone 设置里的配置描述文件;也不同于证书,证书是被列在描述文件里面的。
查看
在 Mac 终端用 security cms -D -i 加文件路径解开,核对设备列表和到期时间。

描述文件是什么?一句话:描述文件(Provisioning Profile,Apple 中文文档叫「预置描述文件」)是 Apple 开发者网站签发的一份授权文件,写明五件事:谁可以签名、可以签哪些应用、能装到哪些设备、到什么时候失效、可以使用哪些权限。iPhone 和 iPad 不运行未经 Apple 授权的第三方代码,这份授权就是靠描述文件带进应用里的。

描述文件是什么,里面写了哪几样东西?

描述文件本质上是一份带加密签名的属性列表,Apple 的技术说明把其中的内容归成五个问题。谁:DeveloperCertificates 列出可以签名的证书。什么:权限里的 application-identifier 指明 App ID,由前缀加套装 ID 组成,可以带通配符。哪里:ProvisionedDevices 逐台列出设备;企业内部类型的描述文件改用 ProvisionsAllDevices,表示适用于所有设备。何时:ExpirationDate 是到期时间。怎样:Entitlements 是一张权限允许清单。

描述文件里的四个关键字段。DeveloperCertificates 列出可以签名的证书,application-identifier 指明 App ID,ProvisionedDevices 列出可以安装的设备,ExpirationDate 是到期时间
第五项是 Entitlements 权限允许清单:应用声明的每一项权限都要在这张清单里。

描述文件出现在哪些地方?

描述文件会在三个地方出现。第一处是开发者账户的「证书、标识符和描述文件」页面,边栏 Profiles 一栏列着团队手动创建的每一份;由 Xcode 自动管理的那些不会显示在这里。第二处是你的电脑:在后台点 Download 之后,「下载」文件夹里会多出一个扩展名为 .mobileprovision 的文件,Mac 应用用的扩展名是 .provisionprofile。第三处是安装包内部:iOS 应用的包里有一个名叫 embedded.mobileprovision 的文件,系统运行应用时核对的就是这一份。

描述文件常和哪些词混在一起?

描述文件最容易和「配置描述文件」混在一起。iPhone「设置」里「通用」下的「VPN 与设备管理」所列的描述文件,属于配置描述文件,用来下发企业或学校的网络、账户等设置,并不负责给某个应用授权。第二个易混的词是证书:证书证明签名的人是谁,描述文件规定这个人签的哪个应用能在哪些设备上运行,证书是被列在描述文件里面的。第三个是权限声明:应用自己要用的权限写在代码签名里,描述文件里的只是允许清单,应用声明的每一项都必须落在清单之内。

怎样在自己的电脑上看到一份描述文件的内容?

在 Mac 的「终端」里用系统自带的 security 命令,就能把描述文件解成可读的文本。Apple 技术说明给出的写法是 security cms -D -i 后面跟上描述文件的路径,输出的属性列表里能直接看到上面五项。假设你拿到一个测试包却装不上,可以先把包里的 embedded.mobileprovision 取出来解开,查 ProvisionedDevices 里有没有那台手机的 UDID、ExpirationDate 有没有过期。Apple 同时提醒,这个文件的具体格式没有正式文档,随时可能变化,只适合用来理解和排查。

解开描述文件查两项的流程。第一步取出安装包里的 embedded.mobileprovision,第二步在终端运行 security 命令把它解成文本,第三步查设备列表里有没有目标手机的 UDID,第四步查到期时间是否已过
测试包装不上时,先用这四步排除设备未登记和描述文件过期。

同样叫描述文件,开发、Ad Hoc 和上传用的有什么不同?

描述文件按用途分成几种类型,名字相同,限制并不一样。开发类型搭配开发证书和已注册的设备,用于调试;Ad Hoc 类型搭配分发证书和选定的已注册设备,创建之后不需要 Xcode 就能在这些设备上运行应用;App Store Connect 类型用于上传,Apple 的技术说明指出这一类里没有设备列表。所以测试包装不上,不一定是设备没有登记:如果手里的包是用上传类型的描述文件签的,它本来就不是给设备直接安装用的,需要换一种类型重新导出。

描述文件失效了怎么办,怎样确认已经恢复?

描述文件失效后,要在开发者账户里重新生成,再用新文件给应用重新签名。按 Apple 账户帮助的说明,撤销了证书、停用了其中的设备、启用或停用了某项应用服务,或者描述文件到期,都需要编辑或重新生成;有效期因类型而异,通常不超过一年。确认恢复要看三处:后台 Profiles 列表里这一份不再是无效或到期状态;重新导出的包里,解开后的到期时间是新的,设备列表包含目标设备;在那台设备上重新安装后能正常打开。三处都对上才算解决。这里提到的证书、UDID 和权限声明,苹果签知各有单独的词条。

咨询
办理
咨询苹果签名办理