本文将为您介绍通过自动集成的方式集成 Unity Plugin SDK。
前提条件
终端性能监控 Pro 需要使用 BuglyPro-UnityPlugin 1.7.6及以上版本。
集成前,请确认已经在终端性能监控 Pro 创建产品,并获取了对应的 AppKey 和 AppID。
自动集成
1. 下载并导入 Bugly Unity Plugin 到 Unity 项目工程。下载最新版本的 BuglyPro Unity Plugin,双击 .unitypackage 文件。
2. 根据平台需求导入 Plugin 的相关文件到您的 Unity 工程中。如果您正在使用旧版本 Plugin 包,请务必先删除旧版本相关的文件。
>> 下载包目录结构说明>> - buglyPro_plugin_*.unitypackage - Bugly Unity Plugin包, 提供C#异常捕获功能及原生SDK接口封装>
说明:
buglyPro_plugin_*.unitypackage 目录结构说明:
Assets/Plugins/BuglyPlugins:Plugin 脚本。
Assets/Plugins/BuglyPlugins/Android/libs:Android 平台依赖的原生 SDK(.jar) 及 NDK 组件(.so)。
Assets/BuglyPro.framework:iOS 平台依赖的原生 SDK 静态库,默认使用 libc++ 编译静态库。如需使用 libstdc++ 编译的静态库,可以使用 BuglySDK/iOS/libstdc++/BuglyPro.framework 替换。
3. (可选)集成 Bugly Unity Plugin 之后,如需发布到 Android 平台,需集成对应的 Android 平台的 SDK 组件。您需要修改 Android 工程的配置文件 AndroidManifest.xml,支持以下两种方式:
Android 的 SDK 组件可以在导出的 Android 工程中集成并修改配置,详情可参见 Android SDK 接入指南。
把组件的内容拷贝到工程 Plugins / Android 目录下,并修改 AndroidManifest.xml 的权限声明。修改导出的 Android 工程的 AndroidManifest.xml 文件中的权限声明,添加如下权限:
<!-- 网络通信--><uses-permission android:name= "android.permission.INTERNET" /><!-- 获取网络状态 --><uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" /><!-- 获取MAC地址--><uses-permission android:name="android.permission.ACCESS_WIFI_STATE" /><!-- 获取设备信息 --><uses-permission android:name= "android.permission.READ_PHONE_STATE" /><!-- 可选的权限: --><!-- 获取logcat日志 --><uses-permission android:name="android.permission.READ_LOGS" />
注意:
如果权限声明已经添加,不用重复添加。
4. 至此 Unity 项目的 Android 工程配置完成。您可以在 Unity 项目中触发 C# 的异常进行测试验证。
说明:
Bugly 的内存和卡顿等性能监控存在一定的 CPU 消耗,请游戏业务在线上谨慎使用;
业务可以通过 SDK 配置中调整采样率控制某些能力使用;