CocosCreator快速接入bugly

CocosCreator快速接入bugly 继续讨论:
[原文已不可编辑,只好新开一帖]

前言

目前从我了解的渠道来看,bugly接入的方式主要有两种:

  • 使用“年久失修”的Cocos plugin
  • 使用js的window.onError接口
    本文要介绍的是第三种方式,c++抛出异常,原生进行上报,这种方式的好处是:
  1. 相对Cocos plugin而言,无需另外接入一套c++的sdk,并且安卓无需修改mk文件。
  2. 相对js脚本报错,这种方式更加灵活,且更容易做成公共模块

接入

创建CCC工程并编译原生项目

首先我们创建一个CCC工程,
在这里插入图片描述
在这里插入图片描述
可以看到我们并没有拖入label节点,所以这段代码是会报错的,然后我们构建原生工程,因为这里要介绍ios和android的接入,所以我们构建了android和ios两个平台,构建后的目录


我使用的CCC是2.4.X版本,不同版本会略有差异,但不影响接入。

Bugly原生SDK接入

安卓端接入

如果你对安卓比较熟悉,请参考官方文档接入,如果你不是很熟悉,可以参考我的接入方式

集成sdk

打开Module(就是app目录)的build.gradle,添加bugly的依赖,添加完毕后的代码

dependencies {
    implementation fileTree(dir: '../libs', include: ['*.jar','*.aar'])
    implementation fileTree(dir: 'libs', include: ['*.jar','*.aar'])
    implementation fileTree(dir: "/Applications/CocosCreator/Creator/2.4.3-rc.1/CocosCreator.app/Contents/Resources/cocos2d-x/cocos/platform/android/java/libs", include: ['*.jar'])
    implementation project(':libcocos2dx')
    implementation 'com.tencent.bugly:crashreport:latest.release'
    implementation 'com.tencent.bugly:nativecrashreport:latest.release'
}

这里的latest.release指最新版本,推荐各位指定版本,这样以后编译速度会快点。

初始化及方法实现

看到很多对安卓不太了解的开发者,根据官方事例,将许多方法写到了AppActivity中,其实这样既不美观也不利于后期维护,推荐各位将模块划分清楚,这里我在包下面建立一个BuglyAgent.java文件,来实现bugly的功能。
本demo主要介绍异常上报,所以实现了两个方法:初始化及异常上报。详细代码

package cn.xyzzlky.bugly;

import android.content.Context;

import com.tencent.bugly.crashreport.CrashReport;

import java.util.Map;

public class BuglyAgent {
    public static void initSDK(Context context, String appId) {
        CrashReport.initCrashReport(context.getApplicationContext(), appId, false);
    }

    public static void postException(int category, String name, String reason, String stack){
        postException(category, name, reason, stack, null);
    }

    public static void postException(int category, String name, String reason, String stack, Map<String, String> extraInfo){
        CrashReport.postException(category, name, reason, stack, extraInfo);
    }
}

方便c++那边的代码调用,所以我直接将最后一个参数设置为null了。别忘了在合适的位置(比如AppActivity)初始化SDK

public class AppActivity extends Cocos2dxActivity {

    @Override
    protected void onCreate(Bundle savedInstanceState) {
		// ...
        BuglyAgent.initSDK(this, "Bugly的APPID");
        // ...
    }
}

Android的原生接入到这里就结束了,你只要记住你实现异常上报方法的包名、类名和方法名就可以了,比如我这里的包名是,cn.xyzzlky.bugly,类名是BuglyAgent,方法名是postException。

IOS接入

如上一致,如果你对ios比较熟悉,请直接参考官方文档接入,如果不熟悉,可以参考我的方法

SDK接入

  1. 如果你已经安装了cocoa,请直接pod接入
  2. 如果没有,你可以安装cocoa,然后用方法1,也可以下载下来,然后参考官方文档,注意选项和依赖库
    在这里插入图片描述

初始化及方法实现

相关代码不多介绍,直接贴出来
BuglyAgent.h代码

@interface BuglyAgent : NSObject

+ (void)initSdk:(NSString *)appId;
+ (void)reportExceptionWithCategory:(NSUInteger)category name:(NSString *)name reason:(NSString *)reason callStack:(NSArray *)stackArray  extraInfo:(NSDictionary *)info terminateApp:(BOOL)terminate;

@end

BuglyAgent.mm 代码

#import "BuglyAgent.h"
#import <Bugly/Bugly.h>

@implementation BuglyAgent

+ (void)initSdk:(NSString *)appId
{
    [Bugly startWithAppId:appId];
}

+ (void)reportExceptionWithCategory:(NSUInteger)category name:(NSString *)name reason:(NSString *)reason callStack:(NSArray *)stackArray  extraInfo:(NSDictionary *)info terminateApp:(BOOL)terminate
{
    [Bugly reportExceptionWithCategory:category name:name reason:reason callStack:stackArray extraInfo:info terminateApp:terminate];
}

@end

同样的我们在适当的位置(比如AppController.m)初始化sdk

// ...

#import "BuglyAgent.h"

// ...
@implementation AppController

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    
    // ...
    
    [BuglyAgent initSdk:@"Bugly的APPID"];
    
    // ...
}

IOS的接入方式也完毕了,同样记住类名和方法名,比如我的类名是BuglyAgent,方法名是reportExceptionWithCategory:name:reason:callStack:extraInfo:terminateApp:

C++代码修改

捕获异常

因为CCC很贴心的暴露了异常捕获的接口,所以我们直接拿来用就好了,位置在**/frameworks/runtime-src/Class/AppDelegate.cpp中,如下:

    se->setExceptionCallback([](const char *location, const char *message, const char *stack) {
        // Send exception information to server like Tencent Bugly.
        cocos2d::log("\nUncaught Exception:\n - location :  %s\n - msg : %s\n - detail : \n      %s\n", location, message, stack);   
    });

调用java方法

c++调用java的方法,使用CCC的JniHelper类就好了,调用方式

 JniHelper::callStaticVoidMethod("类名", "方法名", ...参数);

这里注意类名是全路径,并且包名的".“需要用”/"代替,比如我们调用的方法为

JniHelper::callStaticVoidMethod("cn/xyzzlky.bugly/BuglyAgent", "postException", 5, "JSError", message, stack);

参数解释:

  1. 5是JS错误的标志,Bugly定义的,参考com.tencent.bugly.BuglyStrategy。
  2. 错误的名字,自定义是可以的,Bugly是这么定义的。
  3. 错误的原因
  4. 错误的堆栈

如上,安卓已经接入完毕(其实还有个步骤,下面介绍),直接运行,bugly就可以看到错误了。

调用OC方法

安卓接入了,那ios呢?是不是也直接调用oc呢?不好意思,c++不支持直接调用oc,怎么办?所以我们要写一个c的桥接层,来完成oc的接入。
先把桥接代码奉上
CrashReport.h 代码

class CrashReport
{
public:

    static void reportException(const char* msg, const char* traceback);
    
    CrashReport();
};

CrashReport.mm 代码

#include "CrashReport.h"

#define BUGLY_CLASS @"BuglyAgent"
#define BUGLY_METHOD_EXCEPTION @"reportExceptionWithCategory:name:reason:callStack:extraInfo:terminateApp:"

CrashReport::CrashReport(){
   
}

void CrashReport::reportException(const char* msg, const char* traceback) {
    Class clazz = NSClassFromString(BUGLY_CLASS);
    if (clazz) {
        SEL selector = NSSelectorFromString(BUGLY_METHOD_EXCEPTION);
        NSMethodSignature* signature = [clazz methodSignatureForSelector:selector];
        
        NSInteger category = 5;
        NSString *name = @"JSError";
        NSString *reason = NULL == msg ? @"" : @(msg);
        NSString *track = NULL == traceback ? @"" : @(traceback);
        NSArray *trackArray = [track componentsSeparatedByString:@"\n"];
        NSDictionary *info = nil;
        BOOL terminate = NO;
        
        if (signature) {
            NSInvocation* invocation = [NSInvocation invocationWithMethodSignature:signature];
            if (invocation) {
                [invocation setTarget:clazz];
                [invocation setSelector:selector];
                [invocation setArgument:&category atIndex:2];
                [invocation setArgument:&name atIndex:3];
                [invocation setArgument:&reason atIndex:4];
                [invocation setArgument:&trackArray atIndex:5];
                [invocation setArgument:&info atIndex:6];
                [invocation setArgument:&terminate atIndex:7];
                [invocation invoke];
            }
        }
    }
}

此处的代码含义,与java一致。
然后就可以供c++调用

// ...
#include "CrashReport.h"
// ...
	CrashReport::reportException(message, stack);
// ...

同样,运行ios,后台就可以看到日志了。

最后一步

是不是发现,接完ios,安卓貌似报错了,提示#include "CrashReport.h"有错误,对了,因为我们没有进行mk文件修改,在安卓中,我们是没法调用这个方法的,所以我们还要对平台区分,同时为了维护方便,我们把安卓的类名进行常量定义,所以头文件变为

#if(CC_TARGET_PLATFORM == CC_PLATFORM_ANDROID)
#define BUGLY_CLZ_NAME "cn/xyzzlky/bugly/BuglyAgent"
#elif(CC_TARGET_PLATFORM == CC_PLATFORM_IOS)
#include "CrashReport.h"
#endif

而调用的地方同理

    se->setExceptionCallback([](const char *location, const char *message, const char *stack) {
        // Send exception information to server like Tencent Bugly.
        cocos2d::log("\nUncaught Exception:\n - location :  %s\n - msg : %s\n - detail : \n      %s\n", location, message, stack);
        
#if(CC_TARGET_PLATFORM == CC_PLATFORM_ANDROID)
       JniHelper::callStaticVoidMethod(BUGLY_CLZ_NAME, "postException", 5, "JSError", message, stack);
#elif(CC_TARGET_PLATFORM == CC_PLATFORM_IOS)
        CrashReport::reportException(message, stack);
#endif
        
    });

这里,我们的工作总算接入完毕了。

效果查看


这里有些建议

  1. 我这js没有加密,如果加密了,原js文件在"js backups (useful for debugging)",建议每个线上包,将这个备份下
  2. 因为可能有热更,所以js报错与app版本可能不一致,推荐各位将js的版本也上报给bugly

总结

一路下来,其实并没有什么难点,而其中原生调用方法,可能各位没看到,其实一开始我也不知道还有这些方法,是根据CocosPlugin的api反推的,所以一些东西还是要多去探索,相关demo会在公众号上传。最后,原创不易,欢迎转载。如果此文对你有所帮助,可以给点打赏。
本人公众号
在这里插入图片描述

打赏码

15赞

赞,战略mark

我比较喜欢用 sentry

大家对bugly有误解,直接用腾讯官方的bugly接入就可以了。

那个是自己搭建服务器,性质不一样

官方的bugly?还有第三方的bugly吗?:joy:

不要用这种c++转下的
这种太老旧了

之前接入过,但是因为接口变动太大就放弃了。当时看官方的bugly最后一次维护是17年5月,以为cocos方面的不维护了。

新的是什么样的?

直接接原生,BuglyAgent过时了

这个帖子停止讨论关于使用js直接调用还是c++直接调用的讨论吧,我在开头就讲了他的这种方式的问题。详细的说明,在他的帖子里也讲了,继续讨论,我感觉都牛头不对马嘴。

在吗?怎么上传 console.error(“ content ”) 强制报错的内容呢? 空指针现在可以上报了, 我想看里面的值,cc.log 肯定得不到,console.error() 可以吗?

你直接调用Bugly的打印就可以了

该应用版本未配置符号表文件,堆栈中的源代码类名、行号等信息可能无法正常显示,这个怎么解决

在gradle中把bugly的配置加上

顶,我接的bugly只会打印android的错,js的错无法监听,原来还要改c++

bugly在debug模式下可以输出错误,release下不能输出错误

不要把那个c++与java交互的类混淆

大佬,可以说的具体点吗