SDK 集成

最近更新时间:2026-05-21 17:17:42

我的收藏
本文将为您介绍通过自动集成的方式集成 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 配置中调整采样率控制某些能力使用;