{ iOS }

  • 关于exportOptions.plist的说明

    | /

    一、 简介

    我们在使用xcodebuild命令行工具进行自动化构建过程中，会用到-exportOptionsPlist这个命令指定一个配置文件，xcodebuild会使用该文件导出合适的ipa文件。在这里就简单说明一下这个配置文件的内容。

    二、 说明

    compileBitcode

    参数类型：Bool

    该参数告诉Xcode是否需要通过bitcode重新编译，需要与app中的Enable Bitcode配置一致。

    destination

    参数类型：String

    该参数用来确认当前app是本地导出还是上传到Apple的服务器。可以填写的值为export、upload，默认值为export。

    distributionBundleIdentifier

    参数类型：String

    该参数用来格式化包内可用目标的bundle identifier。

    embedOnDemandResourcesAssetPacksInBundle

    参数类型：Bool

    该参数在非app store的导出类型下有效。如果app使用了On Demand Resources功能，该选项为YES时，app将会加载所有的资源，可以在没有服务器支持下使用该app。如果没有配置onDemandResourcesAssetPacksBaseURL选项，则默认值为YES。

    generateAppStoreInformation

    参数类型：Bool

    该参数在app store的导出类型下有效。在iTMSTransporter上传时判断是否生成App Store的相关信息。默认值为NO。

    iCloudContainerEnvironment

    参数类型：String

    manifest

    参数类型：Dictionary

    该参数在非app store的导出类型下有效。该参数用于web上安装测试应用包使用。该字典包含appURL、displayImageURL、fullSizeImageURL，如果使用了On Demand Resources，还需要配置assetPackManifestURL。

    method

    参数类型：String

    该参数确定Xcode该如何导出应用包。可用的选项为：app-store、validation、ad-hoc、package、enterprise、development,、developer-id和mac-application。默认值为development。

    onDemandResourcesAssetPacksBaseURL

    参数类型：String

    该参数在非app store的导出类型下有效。如果app使用了On Demand Resources，并且embedOnDemandResourcesAssetPacksInBundle配置不是YES，则需要配置该字段。该配置确定app如何下载On Demand Resources资源。

    provisioningProfiles

    参数类型：Dictionary

    该参数在手动配置签名下生效。指定包内所有可执行文件的描述文件。其中key为可执行文件对应的bundle identifier，value为描述文件的文件名或UUID。

    signingCertificate

    参数类型：String

    该参数在手动配置签名下生效。可以配置为证书名称、SHA-1 Hash或者自动选择。其中自动选择允许Xcode自动选择最新可以使用的证书，可选值为：”iOS Developer”、”iOS Distribution”、”Developer ID Application”、”Apple Distribution”、”Mac Developer”和”Apple Development”。默认值和导出类型相关。

    signingStyle

    参数类型：String

    该选项用来确定签名方式，可选值为manual和automatic。如果app配置为自动签名，打包前可以修改此配置，否则该配置会被忽略。

    stripSwiftSymbols

    参数类型：Bool

    该参数用来确认是否需要对swift库进行裁剪。默认值为YES。

    teamID

    参数类型：String

    该参数表明导出包使用的开发者ID。

    thinning

    参数类型：String

    该参数在非app store的导出类型下有效。使用该参数可以打包出指定设备的精简包。可选项为（不精简）、（生成一个通用包和所有精简包）或者指定设备的标识符（如：”iPhone7,1”）。默认值为。

    uploadBitcode

    参数类型：Bool

    该参数在app store的导出类型下有效。用来配置导出的包是否包含bitcode。默认值为YES。

    uploadSymbols

    参数类型：Bool

    该参数在app store的导出类型下有效。用来配置导出的包是否包含符号表。默认值为YES。

    三、 参考

    使用命令xcodebuild -help。

  • iOS系统的沙盒机制

    | /

    一、iOS系统的沙盒机制

    沙盒机制介绍

    沙盒机制是iOS系统中的一种安全体系。每个iOS程序都有一个独立的文件系统（存储空间），而且只能在对应的文件系统中进行操作，此区域被称之为沙盒。所有非代码文件都保存在此，如属性文件plist、文本文件、图像、图标、媒体资源等。

    并且不像安卓系统，iOS系统比较封闭，也没有提供内存卡扩展的功能，没有开放文件管理，所以在手机上是看不到文件目录的。

    沙盒机制的一些规则

    每个应用程序都有自己的存储空间
    应用程序不能翻过自己的围墙去访问其他应用的存储空间内容
    应用程序请求的数据需要通过权限检测,若不符合条件,则不会被放行
    如果需要访问其他某些资源,比如相册、通讯录、麦克风、地理位置等，需要经过用户同意才可以获取。
    每次应用程序重新开启时目录名称会改变。
    沙盒目录的结构

    主要包含4个目录 MyApp.app、Documents、Library、tmp

    一个应用的沙盒目录结构

    s

    MyApp.app

    该目录存放应用本身的数据，包括资源文件和可执行文件。该目录是只读的，如果改变这个目录，将会改变应用程序的签名，应用将会无法启动。不会被iTunes和iCloud同步。

    Documents

    该目录主要存放用户产生的文件，该目录会被iTunes和iCloud同步。

    Library

    苹果建议用来存放默认设置或其他状态信息，该目录除Caches子目录以外会被iTunes和iCloud同步。

    Library/Caches

    主要存放缓存文件，比如音乐缓存，图片缓存等，用户使用过程中的缓存都可以保存在这个目录中，可用于保存可再生文件，应用程序也需要负责删除这些文件，该目录不会被iTunes和iCloud同步。

    Library/Preferences

    存放应用偏好设置文件，该目录会被iTunes和iCloud同步。

    tmp

    存放各种临时文件，保存应用再次启动时不需要的文件。当应用不再需要这些文件时应该主动将其删除。该目录的文件会被系统清理，比如系统磁盘空间不足的时候。该目录不会被iTunes和iCloud同步。

    二、获取各种文件目录的路径

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18

    // 获取沙盒主目录路径
    NSString *homeDir = NSHomeDirectory(); 

    // 获取Documents目录路径
    NSString *docDir = [NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES) firstObject];

    // 获取Library的目录路径
    NSString *libDir = [NSSearchPathForDirectoriesInDomains(NSLibraryDirectory, NSUserDomainMask, YES) lastObject];

    // 获取Caches目录路径
    NSString *cachesDir = [NSSearchPathForDirectoriesInDomains(NSCachesDirectory, NSUserDomainMask, YES) firstObject];

    // 获取tmp目录路径
    NSString *tmpDir =  NSTemporaryDirectory();

    //应用程序程序包的路径
    [[NSBundle mainBundle] bundlePath]

    三、NSSearchPathForDirectoriesInDomains

    方法用于查找目录，返回指定范围内的指定名称的目录的路径集合。有三个参数：

    directory

    NSSearchPathDirectory类型的enum值，表明我们要搜索的目录名称，比如这里用NSDocumentDirectory表明我们要搜索的是Documents目录。如果我们将其换成NSCachesDirectory就表示我们搜索的是Library/Caches目录。

    domainMask

    NSSearchPathDomainMask类型的enum值，指定搜索范围，这里的NSUserDomainMask表示搜索的范围限制于当前应用的沙盒目录。还可以写成NSLocalDomainMask（表示/Library）、NSNetworkDomainMask（表示/Network）等。

    expandTilde

    BOOL值，表示是否展开波浪线。我们知道在iOS中的全写形式是/User/userName，该值为YES即表示写成全写形式，为NO就表示直接写成“~”。

    引用链接

    iOS 沙盒目录结构及正确使用

    File System Basics

    Function NSSearchPathForDirectoriesInDomains(::_:)