快速入门
业务系统分析
创建业务系统
分析业务系统
Web应用性能管理
理解应用性能管理
管理应用列表
查看应用概览
追踪关键事务
追踪请求详情
分析单个请求
分析单次请求快照
追踪外部服务
分析消息队列
追踪数据库详情
追踪NoSQL详情
追踪错误&异常信息
对比分析
设置应用
后台任务性能管理
后台任务概述
管理后台任务列表
查看后台任务概览
追踪慢后台任务
追踪单次慢后台任务
追踪错误信息
运维者视图
创建运维视图
分析运维视图
设置运维视图
移动应用性能管理
理解移动应用性能管理
移动应用概览
用户行为分析
网络分析
Webview性能分析
运营分析
地域分析
崩溃分析
ANR/卡顿分析
组合分析
劫持分析
交互分析
移动拓扑分析
移动应用设置
浏览器性能管理
理解浏览器性能管理
向前端页面注入JS
查看浏览器项目列表
查看Web页面性能概览
按区域分析Web页面性能
按网页分析Web页面性能
按浏览器分析Web页面性能
按运营商分析Web页面性能
多维度追踪单页面请求性能
分析Web页面Ajax请求
分析Web页面JS错误
主机性能管理
理解主机性能管理
管理主机和服务列表
查看主机概览
分析服务器性能
分析Apache性能
分析Redis性能
分析MySQL性能
分析Memcache性能
分析Tomcat性能
分析MongoDB性能
分析Nginx性能
分析Weblogic性能
分析Oracle性能
分析SQL Server性能
分析PostgreSQL性能
分析Varnish性能
分析CouchBase性能
分析Java虚拟机性能
分析Docker性能
设置主机信息
告警管理
概述
设置应用/移动告警/浏览器告警
设置主机告警
查看并处理告警
管理告警
设置URL回调
报告管理
概述
查看在线报告
预定邮件报告
创建自定义报告
账户管理
用户权限说明
管理部门和用户
设置个人信息

安装Smart SDK之前,您需要在透视宝云端的“配置移动”页面中创建一个应用来获取App Key。为方便查看采集的数据,您需要为App应用设置一个有代表性的名称,可以是中文、英文、数字或三者的任意组合,但不能为空,否则无法获取App Key。

保存应用后,透视宝自动生成对应的App Key,安装Smart SDK时需要使用该App Key,如下图所示。

1462845213399544.png

选择移动平台类型(iOS)后,点击<下载Smart SDK for iOS(版本)>按钮下载最新版本的Smart SDK安装包。解压下载的安装包后,开始安装配置Smart SDK。

除以前的普通安装方式外,目前还支持CocoaPods安装方式,下面对各安装方式进行详细说明。

普通安装

CocoaPods安装


普通安装

添加Smart SDK到Xcode项目

解压安装包后,将“CloudwiseMAgent.framework”文件拖拽到待监控App的Xcode工程的Frameworks目录下,如下图所示。

1488940948729345.png

在打开的对话框中选择“Copy items if needed”选项,点击<Finish>按钮确认选择即可,如下图所示。

1462845230397589.png

使用WKWebView监控时,请注意以下问题:

  • App工程里未使用WKWebView时,嵌入Smart SDK后,如果编译时报webkit错误,请在“TARGETS→Build Phases→Link Binary With Libraries”中添加WebKit.framework,并将其Status置为Optional。

1497344858758294.png                                             

  • 开启对WKWebview的监控时,请务必在App工程中实现WKNavigationDelegate的webView:decidePolicyForNavigationAction:decisionHandler:回调。实现该回调之后,如有必要,请在该回调中过滤掉以字符串“cloudwise”开头的scheme。比如可以这样过滤:

if([navigationAction.request.URL.scheme hasPrefix:@"cloudwise"]){
        //nothing to do
    }

在Linker Settings中添加类包

在项目导航窗口内,点击您的Project并选中App,然后在" Build Phases"选项卡的“Link Binary with Libraries”列表下,添加如下类包:

  • libz.tbd/libz.dylib (Xcode6及以前版本)

  • libstdc++.tbd/libstdc++.dylib (Xcode6及以前版本)

1462845270249988.png  已经安装过Smart SDK时,您只需将最新的Smart SDK重新添加到Xcode项目中,参考“添加Smart SDK到Xcode项目”中的说明即可。

集成libcurl.a

如果coco2d-x App需要监控CURL网络协议,需要替换libcurl库,具体的替换方式如下:

点击页面中的“libcurl.a”链接下载zip包,解压缩后,将其中的libcurl.a文件拷贝至cocos工程中来替换libcurl.a文件即可。

修改程序源文件

不同开发语言的修改方式不同,下面分别介绍Objective-C和Swift语言的修改方法。

Objective-C语言

Swift语言

Objective-C语言

如果使用的是Objective-C语言,需要执行以下修改。

  • 增加导入说明

在项目文件AppDelegate.m的头部,增加如下导入说明:

#import<CloudwiseMAgent/SmartAgent.h>

  • 添加App Key

在项目文件AppDelegate.m的“- (BOOL)application:(UIApplication*)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions ”应用程序启动函数中添加创建应用时生成的App Key,如下:

[[SmartAgent sharedInstance]startOnCloudWithAppKey:@“从portal.toushibao.com生成的appkey”]

1488941492562103.png

Swift语言

如果使用的是Swift语言,需要执行以下修改。

  • 创建桥接文件

首先需要在工程中创建桥接文件,如果工程中已经创建过桥接文件,则可以忽略该步骤。

1、首先,按command+N键来创建一对Objective-C语言的文件,取名为CWSA_OCFile。要注意,这里选择的语言是Objective-C语言。

1468221328645080.png                                         

2、点击<Next>按钮,您会看到下图所示的提示框。

1488941572443366.png

3、点击<Create Bridging Header>按钮,生成我们要用的桥接文件,文件名的格式为:"项目名-Bridging-Header.h",如下图所示。

1488941603304841.png

4、删除步骤1中创建的OC文件CWSA_OCFile,同时选中文件CWSA_OCFile.h和CWSA_OCFile.m,按command+D键打开如下提示框,点击右边的<Move to Trash>按钮即可。

1488941623172391.png

通过以上4步就完成了桥接文件的创建,系统也已经帮我们设置好了路径。检查这个路径的方法:在“工程→TARGETS→Build Settings”中,在搜索框里输入bridging会看桥接路径,如下图所示。

1488941651729792.png

  • 增加导入说明

在创建的桥接文件的头部,增加如下导入说明:

#import < CloudwiseMAgent/SmartAgent.h >

1488941688579768.png

  • 添加App Key

在项目文件AppDelegate.swift的应用程序启动函数“func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool ”中添加创建应用时生成的App Key,如下:

SmartAgent.sharedInstance().startOnCloud(withAppKey: "从portal.toushibao.com生成的appkey")

1506047159726656.png


CocoaPods安装

如果您使用了CocoaPods,需要在工程的Podfile文件中添加如下命令:

pod 'CloudwiseMAgent'

1488945775599350.png

然后在终端进入当前工程的根目录,输入以下命令完成安装:

pod install

集成libcurl.a

如果coco2d-x App需要监控CURL网络协议,需要替换libcurl库,具体的替换方式如下:

点击页面中的“libcurl.a”链接下载zip包,解压缩后,将其中的libcurl.a文件拷贝至cocos工程中来替换原有的libcurl.a文件即可。

修改程序源文件

后续需要修改程序源文件,详细说明请参考“修改程序源文件”中的内容。


其他配置

为了帮助您更好地监控App,我们开放了API接口来支持以下配置:


编译应用程序

修改程序源文件后,清理(Shift+command+K)并重新编译(command+B)修改的App应用程序即可。


查看数据

至此,Smart SDK已经安装部署完成,在模拟器或真实设备中运行App。Smart SDK开始收集数据并生成分析报告,只需要稍等片刻,您就能在移动应用列表中查看数据。