App Extensions篇之Share Extension


轉載請注明出處:http://www.cnblogs.com/zhanggui/p/7119572.html

1.前言

這里主要是對App Extension的一些介紹以及詳細給大家介紹一下Share Extension,后期會添加其他的Extension介紹。

2.開始

主要對App Extension和Share Extension進行介紹。請繼續往下看:

2.1: App Extension的介紹

 官方給的說法是:App Extension可以讓你擴展你的APP的自定義功能和內容,使用戶可以在與其他應用或者系統進行互動的時候去使用它。翻譯的不一定准確,這樣說可能會好理解:我們平時看到的Widget、微信和QQ的share等等,都是App Extension,下圖是一些例子:

其實就是我們經常看到的Widget,但是Widget只是Today Extension,除了Today Extension,還有很多。

一個支持擴展的系統區域叫做一個extension point(擴展點)。每個擴展點的擴展都有自己獨有的使用方法和API。你可以根據你的需求來選擇不同的擴展。官方API里面提出了一個名詞叫:Host app,我們可以把它理解為宿主的App也就是提供應用擴展界面顯示或者功能的App。還有一個container app,我們可以把它理解為容器App,就像上圖的微信share extension,容器app就是微信。

擴展和app不同,擴展無法單獨上架AppStore。盡管你必須使用個app來包含並且分發你的extension,extension也是一個單獨的二進制文件,獨立於用於傳遞和分發的container app。

你可以通過File--->New --->Target來創建Extension,它和其他的target一樣,它和你的app project組合成為一個產品。一個app可以有一個擴展,也可以有多個擴展。最好的創建擴展的方式就是通過Xcode提供的Extension種類選擇自己需要的來創建,里面包含了必要的API以及方法實現。

如果你想讓用戶去使用你的擴展,那么就需要吧你的containing app發布到AppStore,當用戶安裝了你的Containing app,擴展也就安裝了。不同的擴展啟動的方式也不一樣,例如Today Extension,你需要Widget來展示到你的通知中心。擴展也不要亂用,擴展的最佳用戶體驗從來都是希望用戶操作更精簡、更快速,並且專注於單個任務。

 

2.1.1: Extension的種類

我們可以在Xcode的File--->New--->Target里面看到不同平台的Extension,包括iOS、watchOS、tvOS、macOS等等。這里主要介紹iOS,主要包括以下幾種Extensions:

1.Action Extension:動作擴展,在另一個應用程序的上下文中操作或者查看內容

2.Audio Unit Extension:音頻單元擴展

3.Broadcast UI Extension:廣播UI 擴展

4.Broadcast Upload Extension:廣播上傳擴展

5.Call Directory Extension:呼叫目錄擴展

6.Content Blocker Extension:內容攔截器擴展

7.Custom Keyboard Extension:鍵盤擴展,例如第三方的鍵盤,搜狗輸入法,百度輸入法等。

8.iMessage Extension:消息的擴展

9.Intents Extension:Intents擴展

10.Intents UI Extension:Intents UI擴展

11.Notification Content Extension:通知內容擴展

12.Notification Service Extension:通知服務擴展

13.Photo Editing Extension:圖片編輯擴展,在照片app中編輯照片或者視頻

14.Share Extension:分享擴展,發布一個共享網站或者與其他應用共享內容。

15.Shared Links Extension:分享鏈接擴展

16.Spotlight Index Extension:Spotlight 索引擴展

17.Sticker Pack Extension:貼紙包擴展

18.Today Extension:Today擴展,可以快速獲取更新或者在通知中心的近日視圖中執行一項快速任務。

等等。也可直接在這里參見更多extension。

2.1.2: App Extensions的生命周期

先上圖,估計你已經看到了好多次這張圖,恭喜你這次又看到了,因為這個是蘋果官方提供的圖片。

 

 

1.用戶選擇要使用的App extension

2.系統啟動App Extension

3.App Extension 代碼運行

4.運行完之后系統kill掉App Extension

這就是App Extension的生命周期,舉個例子:

一個Share Extension,在圖庫里面你選擇了一張圖片,然后點擊分享,選擇你的Share Extension(第一步),此時系統會啟動你的Share Extension(第二步)。然后你將選擇的圖片分享到指定的程序(例如微信的發送給朋友)(第三步)。接下來分享頁面關閉,系統kill掉了Share Extension。

2.1.3: App Extension的通信方式

App Extension主要的通信是和他的host app(例如微信的Share Extension和微信),來自host app的請求和extension的response。下圖你應該也很熟悉(app 擴展直接和host app溝通):

 

 

 

這個展示的就是正在運行的App Extension、host app和containing app之間的關系。可以看出:Containing App和app Extension並沒有直接的溝通。甚至有的時候Containing app可以不運行,而App Extension直接運行。Containing app和Host app沒有任何的溝通。

在一個典型的request/response中,系統打開代表host app(圖庫)的extension(微信分享的share extension),把host app提供的數據(圖片和選擇的好友)輸送到extension的context,然后extension展示界面,提供一些功能任務(例如微信的分享到朋友)。

還有一種是app extension可以直接和他的containing app溝通:

例如Today Widget,可以直接告訴系統打開他的Containing app,只需要調用NSExtensionContext的openURL:CompletionHandler:方法即可。

2.1.4: 在App Extension中不可以做的事情

一個app extension不能有以下情況:

1.訪問sharedApplication對象。因此不能使用任何該對象的防范

2.使用任何標記NS_EXTENSION_UNAVAILABLE宏的API,或者類似的宏,或者不可用framework里面的API,例如HealthKit framework不能用於app extensions

3.iOS設備訪問相機或者麥克風(iMessage app可以訪問這些資源,只要在Info.plist里面進行配置使用描述即可)

4.運行一個長時間的后台任務(根據不同平台而異)

5.使用AirDrop接收數據

 2.2: Share Extension的簡單使用

這里我們以Share Extension為例進行介紹。

2.2.1: 選擇正確的Extension Point開始開發 

當你創建app extension的時候,可以直接使用Xcode自帶的模板創建你需要的Extension。點擊File--->New--->Target:

從這里選擇符合你需求的Extension,當你創建完畢后,你的項目工程目錄就會多一個文件夾:

可以發現多了一個.swift、.storyboard和一個Info.plist。接下來你也會在Scheme里發現一個Extension,而且多了一個以.appex為后綴的Bundle

這里需要注意:

一個app extension必須在architectures build settings 里面包含arm64(ios)或者x86_64(OS X),否則containing app上架的時候將會被拒絕。Xcode默認的Standard architecture包含了64-bit的architecture。

An app extension target must include the arm64 (iOS) or x86_64 architecture (OS X) in its Architectures build settings or it will be rejected by the App Store. Xcode includes the appropriate 64-bit architecture with its “Standard architectures” setting when you create a new app extension target.

If your containing app target links to an embedded framework, the app must also include 64-bit architecture or it will be rejected by the App Store.

 2.2.2: 來看看默認的App Extension模板

從上面的項目工程目錄看,每個extension都包含了一個plist文件、一個視圖控制器類和一個默認的user interface,這些都是被extension point定義的。我們先來看一下Info.plist里面的東西:

再看看項目工程的Info.plist:

兩者可以進行一個對比,可以看出:

1、CFBundlePackageType不一樣,項目是APPL,而Extension的是XPC!

2、比較明顯的就是App Extension里面多了一個NSExtension的字典。 

在Info.plist中,該文件必須包含NSExtension鍵和擴展點指定的鍵和值的字典。這里的ExtensionPointIdentifier是com.apple.share-services,因為我創建的是Share Extension。

這里注意,如果你的app extension的Info.plist里面包含了UIBackgroundModes key那么將無法通過AppStore的審核。 

 

2.2.3:調試App Extension 

調試App Extension很簡單,你要做的就是選擇(scheme)擴展,然后點擊Run, 就會彈出一個彈框讓你選擇Host app,選擇Host app之后便可以運行調試。比如你調試Share Extension,你可以選擇照片,然后讓照片當Host app,然后運行之后就會打開照片,選擇分享就會看到你的app擴展,然后進行debug斷點處理等。

2.3:Share Extension Demo

先看一下我自己做的分享Demo效果:
 

然后在containing app里面查看分享的圖片:如上圖的第三張圖。先看一下這里默認創建的Share Extension的視圖控制器:

 

class ShareViewController: SLComposeServiceViewController {

    override func isContentValid() -> Bool {
        // Do validation of contentText and/or NSExtensionContext attachments here
        return true
    }

    override func didSelectPost() {
        // This is called after the user selects Post. Do the upload of contentText and/or NSExtensionContext attachments.
    
        // Inform the host that we're done, so it un-blocks its UI. Note: Alternatively you could call super's -didSelectPost, which will similarly complete the extension context.
        self.extensionContext!.completeRequest(returningItems: [], completionHandler: nil)
    }

    override func configurationItems() -> [Any]! {
        // To add configuration options via table cells at the bottom of the sheet, return an array of SLComposeSheetConfigurationItem here.
        return []
    }

}

 

里面主要有三個方法:

isContentValid是用來判斷內容是否可用的,這里可以做一些校驗,比如我們分享的內容是否符合要分享的要求,如果返回false,那么在上圖的Post按鈕就無法點擊了。因為一旦返回false,則說明分享內容不符合要求,也就無法Post了。

configuration是一個配置數組,它可以配置多個列表,例如微信分享的[發送給朋友,分享到朋友圈,收藏]:

 

 didSelectPost是你點擊發送之后處理的事件,比如微信的點擊收藏,可以調用微信的api,然后進行收藏。默認的注釋也說明了本方法的作用:

當用戶選中post之后調用。是對內容或者NSExtensionContext附件的上傳。我這里使用App Group的方式進行app Extension和containing app進行交互。先將內容存儲到UserDefaults,然后再在containing app里面取出圖片展示到containing app里面。

這里我把圖片存儲到了UserDefaults,然后在Containing app里面獲取:

 suite的name是app group的名稱。具體可參見Github源碼里的ShareExtension。 

總結

App Extension的出現使App的使用更加方便,比如系統的天氣widget,還有類似微信(QQ)的分享,完全可以實現不打開containing app而直接使用share extension分享。

 在后續的時間里,將會不定期進行更新,給讀者介紹其他的Extension,如有任何疑問,隨時留言溝通。

參考資料

1、App Extension Programming Guide 

2、深入App Extensions for iOS8

3、Information property List Key Reference

4、App Extension Programming Guide---Share


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM