添加 framework
支持通过cocoapods添加framework或手工添加framewrok两种方式
方式一:通过cocoapods添加framework
pod 'pgyer'
pod 'pgyupdate'
方式二:手工添加framewrok
下载最新版蒲公英 sdk v2.8.9.1 (2018.5.24) (包含应用使用统计,异常上报,用户反馈功能,更新检查)。
更多版本
- 添加 pgysdk.framework,pgyupdate.framework.
将 pgysdk.framework 和 pgyupdate.framework 拖动到你的 xcode 工程里,并勾选“copy items if needed”。
- 配置依赖项
导入 sdk 后,切换到 build phases选项卡中,在 link binary with libraries 中添加如下六个系统 framework:
coretelephony.framework
opengles.framework
coremotion.framework
audiotoolbox.framework
avfoundation.framework
systemconfiguration.framework
如果仅使用检查更新功能,则无需添加依赖项。
获取 app key
注册应用获取 app key
app key:唯一标识一个应用的 key,在蒲公英上的每一个 app 都有一个唯一的 app key,开发者可以在应用管理页面凯发k8地址首页查看。
初始化并调用sdk
在项目的appdelegate.m文件中引入头文件:
#import
#import
在application:didfinishlaunchingwithoptions 中调用 sdk:
//启动基本sdk
[[pgymanager sharedpgymanager] startmanagerwithappid:@"pgy_app_id"];
//启动更新检查sdk
[[pgyupdatemanager sharedpgymanager] startmanagerwithappid:@"pgy_app_id"];
其中pgy_app_id即在蒲公英上获取的app key。
自动上报 crash 异常
调用 sdk 后,用户在使用 app 的过程中的崩溃信息将会发送到蒲公英。蒲公英将会统计错误发生的次数,影响的用户,同时开发者还可以在后台查看崩溃的详细信息,包括错误堆栈,机型等,帮助开发者快速定位错误。
蒲公英后台显示的错误是未经过符号化过的,如果需要查看符号化过的堆栈信息,需将代码对应的 dsym 文件在蒲公英上提交。
注意:在进行本地调试的时候,如果使用 xcode 启动程序,gdb/lldb 会拦截到信号并停止应用运行,所以调试期间的崩溃信息不会被上传到蒲公英。
手动上报异常
sdk除了可以自动上报导致crash的异常之外,开发者还可以手动上报exception。
- (void)reportexception
{
@try {
nsarray *array = [nsarray arraywithobjects:@"", nil];
nsstring *value = [array objectatindex:10];
}
@catch (nsexception *exception) {
[[pgymanager sharedpgymanager] reportexception:exception];
}
}
用户反馈
调用 sdk 后,默认开启用户反馈功能,用户可以通过摇一摇或者三指向上滑动来激活用户反馈功能。
一、关闭用户反馈功能(默认开启):
[[pgymanager sharedpgymanager] setenablefeedback:no];
二、自定义用户反馈激活方式(默认为摇一摇):
// 设置用户反馈界面激活方式为三指拖动
[[pgymanager sharedpgymanager] setfeedbackactivetype:kpgyfeedbackactivetypethreefingerspan];
// 设置用户反馈界面激活方式为摇一摇
[[pgymanager sharedpgymanager] setfeedbackactivetype:kpgyfeedbackactivetypeshake];
上述自定义必须在调用 [[pgymanager sharedpgymanager] startmanagerwithappid:@"pgy_app_id"]
前设置。
三、自定义用户界面风格
开发者可以通过设置用户反馈界面的颜色主题来改变界面风格,设置之后的颜色会影响到title的背景颜色和录音按钮的边框颜色,默认为0x37c5a1(绿色)。
[[pgymanager sharedpgymanager] setthemecolor:[uicolor blackcolor]];
四、自定义摇一摇灵敏度
开发者可以自定义摇一摇的灵敏度,默认为2.3,数值越小灵敏度越高。
[[pgymanager sharedpgymanager] setshakingthreshold:3.0];
五、除了可以使用“摇一摇”和“三指拖动”来激活用户反馈,开发者还可以通过代码来直接激活用户反馈功能:
[[pgymanager sharedpgymanager] showfeedbackview];
检查更新
蒲公英为开发者提供了检查版本更新的功能,当开启此功能后,开发者如果在蒲公英上提交了新版本,则老的版本中,可以弹出更新提示,来提示用户更新到最新版本。版本更新功能的开启方法如下:
在需要检查更新的文件中引入头文件:
#import
然后调用
[[pgyupdatemanager sharedpgymanager] startmanagerwithappid:@"pgy_app_id"]; // 请将 pgy_app_id 换成应用的 app key
[[pgyupdatemanager sharedpgymanager] checkupdate];
如果有更新版本则会提示用户前往更新,如图所示:
如果需要自定义检查更新,则需要调用
[[pgyupdatemanager sharedpgymanager] checkupdatewithdelegete:self selector:@selector(updatemethod:)];
其中updatemethod为检查更新的回调方法。如果有新版本,则包含新版本信息的字典会被回传,否则字典为nil。如果想更新新版本,可通过调用
[[uiapplication sharedapplication] openurl:[nsurl urlwithstring:response[@"downloadurl"]]];