注冊(cè)應(yīng)用獲取 App Key

App Key：唯一標(biāo)識(shí)一個(gè)應(yīng)用的 Key，在蒲公英上的每一個(gè) App 都有一個(gè)唯一的 App Key，開(kāi)發(fā)者可以在應(yīng)用管理頁(yè)面首頁(yè)查看。

通過(guò)Cocoapods添加Framework

pod 'Pgyer'
pod 'PgyUpdate'

手工添加Framewrok

下載蒲公英 SDK (包含應(yīng)用使用統(tǒng)計(jì)，異常上報(bào)，用戶反饋功能，更新檢查)。

1. 添加 PgySDK.framework，PgyUpdate.framework.

將 PgySDK.framework 和 PgyUpdate.framework 拖動(dòng)到你的 Xcode 工程里，并勾選“Copy items if needed”。

2. 配置依賴項(xiàng)

導(dǎo)入 SDK 后，切換到 Build Phases選項(xiàng)卡中，在 Link Binary With Libraries 中添加如下六個(gè)系統(tǒng) framework：

CoreTelephony.framework
OpenGLES.framework
CoreMotion.framework
AudioToolbox.framework
AvFoundation.framework
SystemConfiguration.framework

如果僅使用檢查更新功能，則無(wú)需添加依賴項(xiàng)。

初始化并調(diào)用 SDK

在項(xiàng)目的AppDelegate.m文件中引入頭文件：

#import <PgySDK/PgyManager.h>
#import <PgyUpdate/PgyUpdateManager.h>

在application:didFinishLaunchingWithOptions 中調(diào)用 SDK：

//啟動(dòng)基本SDK
[[PgyManager sharedPgyManager] startManagerWithAppId:@"PGY_APP_ID"];
//啟動(dòng)更新檢查SDK
[[PgyUpdateManager sharedPgyManager] startManagerWithAppId:@"PGY_APP_ID"];

其中PGY_APP_ID即在蒲公英上獲取的App Key。

自動(dòng)上報(bào) Crash 異常

調(diào)用 SDK 后，用戶在使用 App 的過(guò)程中的崩潰信息將會(huì)發(fā)送到蒲公英。蒲公英將會(huì)統(tǒng)計(jì)錯(cuò)誤發(fā)生的次數(shù)，影響的用戶，同時(shí)開(kāi)發(fā)者還可以在后臺(tái)查看崩潰的詳細(xì)信息，包括錯(cuò)誤堆棧，機(jī)型等，幫助開(kāi)發(fā)者快速定位錯(cuò)誤。

蒲公英后臺(tái)顯示的錯(cuò)誤是未經(jīng)過(guò)符號(hào)化過(guò)的，如果需要查看符號(hào)化過(guò)的堆棧信息，需將代碼對(duì)應(yīng)的 dSYM 文件在蒲公英上提交。

注意：在進(jìn)行本地調(diào)試的時(shí)候，如果使用 Xcode 啟動(dòng)程序，gdb/lldb 會(huì)攔截到信號(hào)并停止應(yīng)用運(yùn)行，所以調(diào)試期間的崩潰信息不會(huì)被上傳到蒲公英。

手動(dòng)上報(bào)異常

SDK除了可以自動(dòng)上報(bào)導(dǎo)致Crash的異常之外，開(kāi)發(fā)者還可以手動(dòng)上報(bào)Exception。

- (void)reportException
{
    @try {
        NSArray *array = [NSArray arrayWithObjects:@"", nil];
        NSString *value = [array objectAtIndex:10];
    }
    @catch (NSException *exception) {
        [[PgyManager sharedPgyManager] reportException:exception];
    }
}

用戶反饋

調(diào)用 SDK 后，默認(rèn)開(kāi)啟用戶反饋功能，用戶可以通過(guò)搖一搖或者三指向上滑動(dòng)來(lái)激活用戶反饋功能。

一、關(guān)閉用戶反饋功能(默認(rèn)開(kāi)啟)：

[[PgyManager sharedPgyManager] setEnableFeedback:NO];

二、自定義用戶反饋激活方式(默認(rèn)為搖一搖)：

// 設(shè)置用戶反饋界面激活方式為三指拖動(dòng)
[[PgyManager sharedPgyManager] setFeedbackActiveType:kPGYFeedbackActiveTypeThreeFingersPan];

// 設(shè)置用戶反饋界面激活方式為搖一搖
[[PgyManager sharedPgyManager] setFeedbackActiveType:kPGYFeedbackActiveTypeShake];

上述自定義必須在調(diào)用 [[PgyManager sharedPgyManager] startManagerWithAppId:@"PGY_APP_ID"] 前設(shè)置。

三、自定義用戶界面風(fēng)格

開(kāi)發(fā)者可以通過(guò)設(shè)置用戶反饋界面的顏色主題來(lái)改變界面風(fēng)格，設(shè)置之后的顏色會(huì)影響到Title的背景顏色和錄音按鈕的邊框顏色，默認(rèn)為0x37C5A1(綠色)。

[[PgyManager sharedPgyManager] setThemeColor:[UIColor blackColor]];

四、自定義搖一搖靈敏度

開(kāi)發(fā)者可以自定義搖一搖的靈敏度，默認(rèn)為2.3，數(shù)值越小靈敏度越高。

[[PgyManager sharedPgyManager] setShakingThreshold:3.0];

五、除了可以使用“搖一搖”和“三指拖動(dòng)”來(lái)激活用戶反饋，開(kāi)發(fā)者還可以通過(guò)代碼來(lái)直接激活用戶反饋功能：

[[PgyManager sharedPgyManager] showFeedbackView];

檢查更新

蒲公英為開(kāi)發(fā)者提供了檢查版本更新的功能，當(dāng)開(kāi)啟此功能后，開(kāi)發(fā)者如果在蒲公英上提交了新版本，則老的版本中，可以彈出更新提示，來(lái)提示用戶更新到最新版本。版本更新功能的開(kāi)啟方法如下：

在需要檢查更新的文件中引入頭文件：

#import <PgyUpdate/PgyUpdateManager.h>

然后調(diào)用

[[PgyUpdateManager sharedPgyManager] startManagerWithAppId:@"PGY_APP_ID"];   // 請(qǐng)將 PGY_APP_ID 換成應(yīng)用的 App Key
[[PgyUpdateManager sharedPgyManager] checkUpdate];

如果有更新版本則會(huì)提示用戶前往更新，如圖所示：

如果需要自定義檢查更新，則需要調(diào)用

[[PgyUpdateManager sharedPgyManager] checkUpdateWithDelegete:self selector:@selector(updateMethod:)];

其中updateMethod為檢查更新的回調(diào)方法。如果有新版本，則包含新版本信息的字典會(huì)被回傳，否則字典為nil。如果想更新新版本，可通過(guò)調(diào)用

[[UIApplication sharedApplication] openURL:[NSURL URLWithString:response[@"downloadURL"]]];