Reveal集成指南
來自: ??http://support.revealapp.com/kb/getting-started/reveal
注意:最新版的集成指南總是隨著Reveal應(yīng)用一起發(fā)布的。詳細(xì)內(nèi)容請(qǐng)見Help/Integration Guide。
為了讓Reveal能夠在運(yùn)行時(shí),檢視及調(diào)試您的iOS應(yīng)用,首先您需將Reveal庫文件連接入您的應(yīng)用當(dāng)中。而所需的Reveal庫文件已經(jīng)內(nèi)置在Reveal的應(yīng)用程序當(dāng)中。
Reveal提供了以下三種方式來集成庫文件與您的iOS應(yīng)用:
將Reveal的靜態(tài)庫文件連接入應(yīng)用,是最簡單快捷地啟用Reveal檢視的方式。
動(dòng)態(tài)加載允許iOS應(yīng)用在運(yùn)行時(shí),可以按需地加載第三方庫。采用這種方式,庫文件無需連接入應(yīng)用的可執(zhí)行文件,而是被加入到了應(yīng)用Bundle中去,從而在運(yùn)行時(shí)能按需加載。這種方式使得開發(fā)者可以在個(gè)人應(yīng)用中,完全自由地控制Reveal庫的加載,以及其服務(wù)的啟動(dòng)與停止。
→使用動(dòng)態(tài)加載的方式集成Reveal。
CocoaPods是一款針對(duì)iOS與OSX項(xiàng)目的依賴管理系統(tǒng)。它大大簡化了以往Xcode工程里,對(duì)第三方庫的依賴管理與配置工作。
無論您之前采用的是哪種方式來集成Reveal,從Reveal 1.0.x升級(jí)到1.5.x都將是一個(gè)簡單的過程。
在過去已有的庫文件依賴的基礎(chǔ)上,Reveal 1.5.x 新增了對(duì)libz.dylib的連接依賴。
如果在之前的版本中,您已經(jīng)將靜態(tài)框架文件或動(dòng)態(tài)庫文件拷貝到工程中。那么在升級(jí)后,請(qǐng)確保拷貝最新版本的庫文件,以替換之前舊版本的庫文件。(庫文件的位置請(qǐng)參照,Help → Show Reveal Library in Finder)
在Xcode的Project Navigator面板中,選中您的工程,對(duì)于每一個(gè)集成過Reveal的target,您都需要進(jìn)行以下操作:
如果之前已經(jīng)在Link Binary with Libraries中加入過Reveal所需的庫文件,現(xiàn)在請(qǐng)將libz.dylib也加入列表(已經(jīng)加過的,無需重復(fù)加入)。
如果您之前是通過build setting中的**Other Linker Flags**配置項(xiàng)(或OTHER_LDFLAGS),來連接Reveal所需庫文件,現(xiàn)在請(qǐng)?jiān)谂渲庙?xiàng)的flag列表中加入-lz。
搞定 - 運(yùn)行您的應(yīng)用,連上Reveal 1.5!
先確認(rèn)您的*Podfile*看起來大概像這樣子:
pod 'Reveal-iOS-SDK', :configurations => ['Debug']
在工程目錄下執(zhí)行pod update命令。
搞定 - 運(yùn)行應(yīng)用,連上Reveal 1.5!
→根據(jù)說明將Reveal從您的Xcode項(xiàng)目中移除。
不要將連接了Reveal庫文件的應(yīng)用正式發(fā)布。 Reveal的檢視機(jī)制,會(huì)將您應(yīng)用的許多內(nèi)部信息暴露出來,而這將很可能導(dǎo)致您的應(yīng)用被Apple審查團(tuán)隊(duì)拒絕發(fā)布。Reveal的目的僅用于內(nèi)部開發(fā)與應(yīng)用調(diào)試。
當(dāng)iOS宿主應(yīng)用進(jìn)入后臺(tái)后,Reveal服務(wù)將會(huì)自動(dòng)停止。 當(dāng)應(yīng)用重新打開時(shí),它又會(huì)自動(dòng)啟動(dòng)。
Reveal支持基于iOS 6及更新版本而編譯的應(yīng)用。 構(gòu)建配置中的*iOS Deployment Target*也必須是'iOS 6.0'或更新版本。 如果iOS版本太舊,您有可能會(huì)在構(gòu)建應(yīng)用過程中遇到連接錯(cuò)誤。
Reveal使用Bonjour協(xié)議來連接運(yùn)行時(shí)的iOS應(yīng)用。 如果您的iOS應(yīng)用是運(yùn)行在真實(shí)的設(shè)備之上,那么此設(shè)備也需要處在同一個(gè)網(wǎng)絡(luò)之內(nèi),以便電腦上的Reveal應(yīng)用能夠與之連接。如果您在連接應(yīng)用時(shí)仍遇到問題,請(qǐng)先檢查防火墻和代理設(shè)置,以確保它們沒有阻礙通訊。