本文是介紹如何在NDK開發(fā)中引入xlog實現(xiàn)日志記錄,mars團隊已經(jīng)把xlog打包上傳到了jcenter,我們還是直接引用jcenter的xlog仔涩,通過動態(tài)引入的方式鏈接到xlog,實現(xiàn)日志功能。
創(chuàng)建cmake native項目
我們通過Android Studio創(chuàng)建一個C++的項目宫盔,默認(rèn)就是通過cmake管理C++代碼融虽,這里就不介紹創(chuàng)建過程了,那么我們就可以得到一個C++項目:
項目目錄結(jié)構(gòu)
├── app
│ ├── build.gradle
│ └── src
│ └── main
│ ├── AndroidManifest.xml
│ ├── cpp
│ │ ├── CMakeLists.txt
│ │ └── native-lib.cpp
│ ├── java/com/taoweiji/xlogexample/MainActivity.java
│ └── res
├── build.gradle
└── settings.gradle
本文是介紹cmake項目接入xlog灼芭,如果項目還是ndk-build有额,那么本來就不適用,需要把項目先升級到cmake才可以彼绷。
修改 build.gradle
這部分的代碼是要添加xlog的依賴巍佑,也增加拷貝腳本,作用是把 mars-xlog 包里面的 so文件拷貝到 src/main/jniLibs 文件夾寄悯。
configurations {
cmake_depends
}
dependencies {
api "com.tencent.mars:mars-xlog:1.2.5"
cmake_depends "com.tencent.mars:mars-xlog:1.2.5"
}
// 作用是build的時候把 mars-xlog 包里面的 so文件拷貝到 src/main/jniLibs 文件夾
task resolveDependencies {
project.configurations.each { configuration ->
if ("cmake_depends".equalsIgnoreCase(configuration.name)) {
def lib = configuration.resolve()[0]
copy {
from zipTree(lib)
into "${project.rootDir}/${project.name}/src/main/jniLibs/"
include "jni/**/*.so"
}
}
}
}
build.dependsOn resolveDependencies
執(zhí)行build后萤衰,我們就可以看到在 src/main/jniLibs 增加了 xlog 的 so 文件,這里的so文件僅僅只是參與到編譯過程猜旬,不會打包到apk脆栋,apk關(guān)聯(lián)的還是mars-xlog.aar帶有so文件倦卖。
src
└── jniLibs
└── jni
├── arm64-v8a
│ ├── libc++_shared.so
│ └── libmarsxlog.so
└── armeabi-v7a
├── libc++_shared.so
└── libmarsxlog.so
從拷貝的文件可以看到,只包含了 arm64-v8a 和 armeabi-v7a 平臺的 so文件椿争,意味著這個項目無法在 x86 平臺下運行怕膛。
修改 CMakeLists.txt
這部分的代碼是為了查找并鏈接 marsxlog 動態(tài)庫
cmake_minimum_required(VERSION 3.10.2)
project("xlog-example")
include_directories(export_include)
add_library(native-lib SHARED native-lib.cpp)
# 設(shè)置 marsxlog 動態(tài)庫的文件夾
set(XLOG_PATH ../jniLibs/jni/${ANDROID_ABI}/)
# 從 jniLibs 查找對應(yīng)平臺的marsxlog動態(tài)庫
find_library(XLOG_LIB marsxlog PATHS ${XLOG_PATH} NO_DEFAULT_PATH NO_CMAKE_FIND_ROOT_PATH)
# 鏈接 marsxlog 動態(tài)庫
target_link_libraries(native-lib ${XLOG_LIB})
導(dǎo)入頭文件
從 mars 的倉庫下載 xlog 的頭文件,放到 cpp/export_include/xlogger 目錄下秦踪,只需要4個頭文件褐捻,其它文件都不需要。
├── CMakeLists.txt
├── export_include
│ └── xlogger
│ ├── android_xlog.h
│ ├── preprocessor.h
│ ├── xlogger.h
│ └── xloggerbase.h
└── native-lib.cpp
測試
修改 native-lib.cpp椅邓,添加測試代碼
#include <jni.h>
#include <string>
#include "xlogger/xloggerbase.h"
#include "xlogger/xlogger.h"
#include "xlogger/android_xlog.h"
extern "C"
jstring
Java_com_taoweiji_xlogexample_MainActivity_stringFromJNI(
JNIEnv* env,
jobject /* this */) {
xinfo_function();
xdebug2(TSF "test xlog, have level filter. line:%0, func:%1", __LINE__, __FUNCTION__);
xdebug2("test xlog, have level filter. line:%d, func:%s", __LINE__, __FUNCTION__);
xassert2(1<0, "assert false info");
xassert2(false);
xassert2(true);
xverbose2(TSF "test xlog, have level filter");
LOGD("testxlog", "-------user define:%d--------", __LINE__);
__android_log_print(ANDROID_LOG_INFO, "test", "123");
__android_log_print(ANDROID_LOG_INFO, "test", "123:%d", 4);
__android_log_write(ANDROID_LOG_INFO, "test", "123");
__android_log_assert(1>0, "test", "%d", 3455);
__android_log_assert(1<0, "test", "%d", 3455);
__android_log_assert(1<0, "test", "3455dfdddddddddd");
LOGI("test", "111111111111");
std::string hello = "Hello from C++";
return env->NewStringUTF(hello.c_str());
}
修改 MainActivity.java
public class MainActivity extends AppCompatActivity {
static {
System.loadLibrary("native-lib");
}
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
initXLog(this);
TextView tv = findViewById(R.id.sample_text);
tv.setText(stringFromJNI());
}
public native String stringFromJNI();
public static void initXLog(Context context) {
String logPath = context.getFilesDir().getAbsolutePath() + "/logsample/xlog";
Xlog xlog = new Xlog();
Log.setLogImp(xlog);
Log.setConsoleLogOpen(true);
Log.appenderOpen(Xlog.LEVEL_DEBUG, Xlog.AppednerModeAsync, "", logPath, "LOGSAMPLE", 0);
}
}
到這里就大功告成了柠逞,由于mars-xlog只包含了arm架構(gòu)的so,所以只能真機運行希坚,無法在x86的虛擬機上運行边苹。
源碼
https://github.com/taoweiji/cpp-cmake-example/tree/master/xlog