# iOS On-Demand Resources

前言

iOS 9 引入了一个新功能，On-Demand Resources，即按需加载资源，它是 app thinning 的一部分。

On-Demand Resources 的类型

image

注：具体见 官方链接

On-Demand Resources 的好处

• Smaller app size. app体积更小，在上传至 App Store 的时候 ipa 的体积会更小。
• Lazy loading of app resources. 资源延迟加载，app 有一些只在特定情景下使用的资源，当应用可能要进入这些场景时，会请求这些资源。例如，在一个有很多关卡的游戏中，用户只需要当前关卡和下一关卡的资源。
• Remote storage of rarely used resources. 不常用资源的远程存储，app 有一些很少使用的资源，当需要这些资源时会去请求它们。例如，当 app 第一次打开时会展示一个教程，而这个教程之后就可能不会在用到。app 在第一次启动时请求教程的资源，这之后只在需要展示教程或者添加了新功能才去请求该资源。
• Remote storage of in-app purchase resources. 应用内购买资源的远程存储，app 提供包含额外资源的应用内购买。app 会在启动完成后请求已购买模块的资源。例如，用户在一个键盘 app 内购买了 SuperGeeky 表情包。应用程序会在启动完成后请求表情包的资源。

如何开启 On-Demand Resource ？

image

On-Demand Resource 的三种标签

• Initial install tags. 此种标签的资源，会随着 app 从 App Store 下载而下载，但是会影响 app 的 ipa 大小，也就是说此种资源会包含在 ipa 内。
• Prefetch tag order. 此种标签会在 app 下载后，开始下载相应的资源，下载是存在顺序的，后面会说明。此种资源并不会影响 ipa 的大小，也就是说此种资源并不包含在 ipa内。
• Dowloaded only on demand. 此种标签下的资源，会在必要的时候，主动触发下载，这是我们开发者自己控制下载时机的。

如何设置 On-Demand Resource ?

点击导航栏的 Resource Tags，然后点击 + 按钮，上述的三种Tags可以随意设置，此处选择 Prefetched Tag Order，因为要 App 瘦身，也可以选择 Download Only On Demand，区别不再多说了。

image

前面说过，Prefetched Tag Order 是按顺序下载的，下载顺序为自上而下，下图中顺序为：New -> New-1，当然你可以随意切换。
如何添加资源？官网图片如下：

image

图片中在对应的 Tag 下创建了多个文件夹，例如：liama 、magic 、mountain 等等。
点击图中 New tag entry 红框中 New 文件夹下的 + 按钮，会出现供你选择的对话框。

image

被选中的资源文件，在 File inspector 中可以看到该资源位于哪个 Tags 下的那个文件夹中，例如：

image

如何使用 On-Demand Resource ？

系统提供了相应的获取按需加载资源的类，NSBundleResourceRequest ，其提供了2个重要的方法：

• beginAccessingResourcesWithCompletionHandler ：会从 App Store 下载这些资源；
• conditionallyBeginAccessingResourcesWithCompletionHandler ：不会下载资源；

具体参见 Apple API 。
使用如下：

// Create an NSSet object with the desired tags
NSSet *tags = [NSSet setWithObjects: @"New", @"New-1"];

// Use the shorter initialization method as all resources are in the main bundle
resourceRequest = [[NSBundleResourceRequest alloc] initWithTags:tags];
// Request access to the tags for this resource request
[resourceRequest beginAccessingResourcesWithCompletionHandler:
                                 ^(NSError * __nullable error)
    {
        // Check if there is an error
        if (error) {
            // There is a problem so update the app state
            self.resourcesLoaded = NO;

            // Should also inform the user of the error

            return;
        }

        // The associated resources are loaded
        self.resourcesAvailable = YES;
    }
];

上述 tags 中的 New 、New-1 为上述在 Prefetched Tag Order 中创建的标签名称。如何没有错误，New 、New-1 中对应的资源就可以使用了，使用资源文件的方式和正常加载 Bundle 中的文件没有任何差异。
注：不要使用同一个 NSBundleResourceRequest 实例多次请求访问资源，否则让会 Crash。
判断资源是否已经下载可以使用conditionallyBeginAccessingResourcesWithCompletionHandler:来判断，如果回调为 NO ，则可以调用 beginAccessingResourcesWithCompletionHandler: 来下载资源。

如何调试 On-Demand Resource ？

在开发阶段，我们将如何调试，这在研究时真的很费劲，官方文档并没有确切的文字说明，WWDC 视频有提到，但是不确切。搜集大量针对文档和视频的解读，以及自己不断试错，总结如下：

• Initial install tags. ：Testflight 测试；
• Prefetch tag order. ：Testflight 测试、直接 Debug 测试；
• Dowloaded only on demand. 可以使用私有服务区存储资源测试，但上架时需要使用 APP Store 服务；

使用 Dowloaded only on demand. 时，测试需要使用私有服务器，需要设置服务器地址：

image

制作需要存储的资源流程，不过 Apple 已经更新很久了，和现在 Xcode 归档流程不太一样，现在 Archive 后，直接导出至本地，查看 ipa 文件中的内容如下：

image

OnDemandResource 中的文件就是需要上传至私有服务的资源。

参考地址后期会自己完善更多内容