該文章屬于劉小壯原創(chuàng)洼专，轉(zhuǎn)載請注明：劉小壯

前兩天leader讓我調(diào)研一下App Clips雾袱，我簡單調(diào)研了一下妻枕，這是我調(diào)研的一些總結(jié)度秘，大家可以看看垢乙，有問題歡迎評論區(qū)討論钮孵。

簡介

App Clips類似微信的小程序荧库，不需要顯式的去App Store里下載摇邦，蘋果會在對應(yīng)的時(shí)機(jī)進(jìn)行后臺下載。App Clips可以在不打開主App的情況下，單獨(dú)進(jìn)行使用腻异，交互操作和主App無異影斑，例如登錄、列表視圖膳汪、支付等痹换。

使用流程

通過Safari Banner娇豫、iMessage等如下方式浦楣，可以打開App Clips。例如從Safari點(diǎn)擊上面的banner調(diào)起App Clips，系統(tǒng)會根據(jù)調(diào)用URL來確定卡片顯示的原數(shù)據(jù)，隨后將原數(shù)據(jù)例如標(biāo)題、背景圖等顯示在App Clips的卡片頁棍鳖。

卡片頁可以選擇是否開啟通知以及下載App炮叶，進(jìn)入此頁面系統(tǒng)就會開始后臺下載App Clips，點(diǎn)擊open即可打開App Clips渡处。如果已經(jīng)安裝主App镜悉，則打開的就是主App。打開App Clips或主App時(shí)医瘫，都會帶過去一個(gè)URL侣肄，也就是我們配置的invocation URL，可以對此URL進(jìn)行解析醇份，以打開對應(yīng)的頁面或功能稼锅。

調(diào)起流程

開發(fā)

App Clips以主工程的一個(gè)target的形式存在于項(xiàng)目中，與主工程共享代碼及資源文件被芳。App Clips可以訪問藍(lán)牙缰贝、NFC等硬件，相當(dāng)于一個(gè)smart app畔濒。如果有主客戶端則調(diào)起客戶端，如果沒有客戶端則調(diào)起App Clips锣咒。

App Clips從iOS14開始支持侵状，所以可以直接用SwiftUI進(jìn)行開發(fā)。

Apple Connect配置

每個(gè)應(yīng)用程序只能有一個(gè)App Clips毅整，但可以有多個(gè)配置趣兄，配置包括image、title悼嫉、URL等艇潭。根據(jù)不同的URL，展示不同的配置信息。配置信息在Apple Connect填寫蹋凝，例如標(biāo)題鲁纠、封面圖等。

信息

開發(fā)流程

在主工程中新建一個(gè)target并選擇為App Clips鳍寂，并且關(guān)聯(lián)到我們的主工程Fruta即可改含。對于開發(fā)語言我們只能選擇Swift，無論你當(dāng)前的工程是OC還是Swift的迄汛。

因?yàn)锳pp Clips是從iOS14推出的捍壤，而SwiftUI是從iOS13推出的，所以我們可以選擇使用SwiftUI進(jìn)行開發(fā)鞍爱，這也是蘋果推薦的開發(fā)方案鹃觉，當(dāng)然也可以選擇UIKit的方式。

創(chuàng)建項(xiàng)目

創(chuàng)建App Clips后睹逃，系統(tǒng)會生成對應(yīng)的iOSClip.entitlements文件盗扇，需要在里面設(shè)置App Group、Parent Identifier唯卖、Associated Domains粱玲，以關(guān)聯(lián)主App。

我們填寫應(yīng)用程序標(biāo)示符時(shí)拜轨，蘋果推薦以{主App Bundle id}+Clip的格式命名抽减，這種命名也更清晰一些。

客戶端代碼

客戶端對于App Clips需要做的處理橄碾，主要是解析傳入的URL卵沉，其他的就都是業(yè)務(wù)邏輯相關(guān)了。對于URL的處理法牲，使用UIKit和SwiftUI的處理方式不同史汗，如果是UIKit則采用下面的方法處理URL傳參。

UIKit通過UIScene的代理方法接收回調(diào)拒垃，例如下面的方式停撞。

func scene(_ scene: UIScene, continue userActivity: NSUserActivity) {
    guard userActivity.activityType == NSUserActivityTypeBrowsingWeb else { return }
    guard let url = userActivity.webpageURL else { return }

    presentExperience(for: url)
}

func presentExperience(for url: URL) {
    // Route user to the appropriate place in your App Clip.
}

SwiftUI的處理方式需要注冊一個(gè)NSUserActivityTypeBrowsingWeb類型的userActivity，并在回調(diào)方法中解析webpageURL即可悼瓮。

因?yàn)槿绻惭b主App后戈毒，這個(gè)操作就要交由主App來處理，所以主App也需要有相同的處理代碼横堡。

struct FrutaAppClip: App {
    var body: some Scene {
        WindowGroup {
            NavigationView {
                SmoothieMenu()
            }
            .onContinueUserActivity(NSUserActivityTypeBrowsingWeb, perform: handleUserActivity)
        }
    }
    
    func handleUserActivity(_ userActivity: NSUserActivity) {
        guard
            let incomingURL = userActivity.webpageURL,
            let components = NSURLComponents(url: incomingURL, resolvingAgainstBaseURL: true),
            let queryItems = components.queryItems
        else {
            return
        }
    }
}

數(shù)據(jù)共享

App Clips可以和主應(yīng)用共享數(shù)據(jù)埋市，也就是相互訪問沙盒，將二者的group id設(shè)置成相同的即可命贴。這個(gè)App Group是需要在蘋果后臺創(chuàng)建的道宅，如果沒有創(chuàng)建則需要進(jìn)入開發(fā)者中心的Groups選項(xiàng)食听，創(chuàng)建的對應(yīng)的group id。

App Group

不同target或應(yīng)用間訪問沙盒很簡單污茵，可以通過NSUserDefaults并傳入對應(yīng)的group的方式創(chuàng)建userDefaults對象樱报，可以對key、value進(jìn)行操作省咨。

NSUserDefaults *userDefaults = [[NSUserDefaults alloc] initWithSuiteName:@"group.company.appGroupName"];

還可以通過containerURLForSecurityApplicationGroupIdentifier方法獲取到沙盒路徑肃弟，隨后對文件進(jìn)行操作。

NSURL *containerURL = [[NSFileManager defaultManager] containerURLForSecurityApplicationGroupIdentifier:APP_GROUP_ID];
NSURL *directoryPath = [containerURL URLByAppendingPathComponent:GroupShareRelativeDirectory];

通知

App Clips可以接收通知零蓉，在info.plist中配置后笤受，代碼實(shí)現(xiàn)和普通通知一樣〉蟹洌可以通過NSAppClipRequestEphemeralUserNotification字段設(shè)置開啟通知箩兽，如果設(shè)置此字段后默認(rèn)為開啟，但用戶可以點(diǎn)擊options關(guān)閉通知章喉。蘋果允許用戶啟動App Clips后的八小時(shí)內(nèi)向用戶發(fā)送通知汗贫。

卡片

注意點(diǎn)

1. 由于是小程序，所以安裝包大小被限制在10MB以內(nèi)秸脱。
2. 一段時(shí)間不活動后落包，系統(tǒng)會將其刪掉，類似于微信小程序摊唇。
3. 下面這些庫在App Clips不支持咐蝇，編譯時(shí)并不會報(bào)錯(cuò)，但調(diào)用時(shí)會出現(xiàn)調(diào)用無效等問題巷查。CallKit有序、CareKit、CloudKit岛请、HealthKit旭寿、HomeKit、ResearchKit崇败、SensorKit盅称、Speech。
4. 為了保護(hù)用戶隱私后室，在App Clips中下面的API禁止使用微渠。通訊錄、Files咧擂、相冊、iTunes檀蹋。
5. App Clips無法進(jìn)行后臺活動松申，目前看主要是后臺網(wǎng)絡(luò)請求云芦。

代碼差異

在開發(fā)App Clips過程中，由于二者大多數(shù)使用的都是同一份代碼贸桶，有些代碼可能與主程序有差異舅逸，并不能運(yùn)行到主程序或App Clips上』噬福可以通過在Active Compilation Conditions設(shè)置對應(yīng)的環(huán)境變量琉历，來區(qū)分不同的target。

設(shè)置環(huán)境變量

判斷代碼如下水醋。

#if !APPCLIP
// Code you don't want to use in your app clip.
#else
// Code your app clip may access.
#endif

服務(wù)端開發(fā)

在打開App Clips之前旗笔，蘋果會驗(yàn)證配置信息，驗(yàn)證方式是蘋果請求公司服務(wù)器拄踪，公司服務(wù)器返回給蘋果一個(gè)JSON格式的配置文件蝇恶。蘋果要求設(shè)置的請求地址必須是https協(xié)議，并且不能進(jìn)行重定向惶桐。這里的appIDs指的是App Clips配置的bundle id撮弧。

{
  "applinks": {
      "details": [
           {
             "appIDs": [ "ABCDE12345.com.example.app", "ABCDE12345.com.example.app2" ],
             "components": [
               {
                  "#": "no_universal_links",
                  "exclude": true,
                  "comment": "Matches any URL whose fragment equals no_universal_links and instructs the system not to open it as a universal link"
               },
             ]
           }
       ]
   },
   "webcredentials": {
      "apps": [ "ABCDE12345.com.example.app" ]
   }
}

應(yīng)用推薦

可以在APP clips的下方顯示一個(gè)疊層，來推薦用戶下載我們的App姚糊，通過SKOverlay來進(jìn)行配置贿衍。

func displayOverlay() {
    guard let scene = view.window?.windowScene else { return }

    let config = SKOverlay.AppClipConfiguration(position: .bottom)
    let overlay = SKOverlay(configuration: config)
    overlay.present(in: scene)
}

本地測試

進(jìn)行本地測試時(shí)，可以將在Apple Connect中配置的要測試的URL救恨，配置在App Clips的scheme中封拧，并以_XCAppClipURL進(jìn)行命名來測試，記得將其勾選腾务。

這里的域名需要和Associated Domains一致岳链。

設(shè)置調(diào)起URL

審核

App Clips是作為應(yīng)用程序的一部分參與審核的，所以需要隨客戶端版本上線署浩。