Bugly Cocos Plugin 使用指南
概述
Bugly Cocos Plugin 是为基于 Cocos 引擎的App(iOS/Android)封装的 Bugly 原生(iOS/Android) SDK 的接口,方便调用 Bugly 原生 SDK,可用于SDK初始化、设置自定义用户信息、错误等,并自动捕获上报App的脚本(Lua、JavaScript)错误和原生代码(如Objective-C、Java、C/C++等)引发的崩溃信息,提供实时、多维度的异常问题分析服务。
集成步骤
下载 Bugly Cocos Plugin
下载 Bugly Cocos Plugin,根据 Cocos 项目的开发语言(c++、lua、js)集成插件
下载包目录结构说明:
CocosPlugin
bugly - 支持c++的接口封装
bugly/lua - 支持lua的接口封装
bugly/js - 支持js的接口封装
agent/ - 原生SDK(iOS/Android)的接口封装
BuglySDK - 原生SDK(iOS/Android)
集成 Bugly Cocos Plugin
iOS 工程配置
打开 proj.ios_mac 目录的 Xcode 工程,将 bugly 目录的头文件和源文件添加到工程中,并将源文件添加到指定 Target 的 Compile Sources 中,如图
将 agent/iOS 目录的 libBuglyAgent.a 和 BuglySDK/iOS 目录下的 Bugly.framework 添加到 Xcode 工程中,并在 Build Settings 的 Other Linker Flags 配置中添加-force_load标记,设置 libBuglyAgent.a 和 Bugly.framework 的路径,如图
检查 Xcode 工程的 Build Phases 的 Link Binary With Libraries 配置,确认已经添加依赖的动态库,如图
Android 工程配置
将 bugly 目录拷贝到项目编译使用的 Cocos 引擎(源码或框架)目录的 external 子目录,即
{cocos2d-x}/external/bugly
打开 proj.android (或 proj.android_studio) 目录的 Android 工程,将 agent/Android 目录下 .jar 和 BuglySDK/Android 目录下的 .jar 添加到工程的 libs 目录;将 BuglySDK/Android 目录下的 libBugly.so 添加到工程的 jni/prebuilt 目录,如图
修改 proj.android/jni/Android.mk 文件,添加如下配置:
示例:
LOCAL_PATH := $(call my-dir)
# --- 引用 libBugly.so ---
include $(CLEAR_VARS)
LOCAL_MODULE := bugly_native_prebuilt
# 可在Application.mk添加APP_ABI := armeabi armeabi-v7a 指定集成对应架构的.so文件
LOCAL_SRC_FILES := prebuilt/$(TARGET_ARCH_ABI)/libBugly.so
include $(PREBUILT_SHARED_LIBRARY)
# --- end ---
include $(CLEAR_VARS)
LOCAL_MODULE := cocos2dcpp_shared
LOCAL_MODULE_FILENAME := libcocos2dcpp
LOCAL_SRC_FILES := hellocpp/main.cpp \
../../Classes/AppDelegate.cpp \
../../Classes/HelloWorldScene.cpp
LOCAL_C_INCLUDES := $(LOCAL_PATH)/../../Classes
LOCAL_STATIC_LIBRARIES := cocos2dx_static
# 引用 bugly/Android.mk 定义的Module
LOCAL_STATIC_LIBRARIES +=