Android使用C語(yǔ)言庫(kù)入門(mén)

使用Android Studio開(kāi)發(fā)時(shí)使用C庫(kù)來(lái)實(shí)現(xiàn)某些功能,例如需要使用libmobi庫(kù)來(lái)解析mobi格式的文件

一、在已有項(xiàng)目中添加

1.在項(xiàng)目的app(或module)目錄下的src/main新建cpp文件夾(在java同級(jí))
2.在cpp目錄下添加CMakeLists.txt文件

CMakeLists.txt

# Sets the minimum version of CMake required to build your native library.
# This ensures that a certain set of CMake features is available to
# your build.

cmake_minimum_required(VERSION 3.10.2)

# Specifies a library name, specifies whether the library is STATIC or
# SHARED, and provides relative paths to the source code. You can
# define multiple libraries by adding multiple add.library() commands,
# and CMake builds them for you. When you build your app, Gradle
# automatically packages shared libraries with your APK.

#定義一個(gè)變量
set(LIBRARY_NAME parser)

#設(shè)置要編譯的庫(kù)
add_library( # Specifies the name of the library.
             ${LIBRARY_NAME}

             # Sets the library as a shared library.
             SHARED

             # Provides a relative path to your source file(s).
             )

# Specifies a path to native header files.
# include_directories(src/main/cpp/include/)

#主要是找NDK中的庫(kù)
find_library( # Defines the name of the path variable that stores the
              # location of the NDK library.
              log-lib

              # Specifies the name of the NDK library that
              # CMake needs to locate.
              log )

# Links your native library against one or more other native libraries.
#將本機(jī)庫(kù)鏈接到一個(gè)或多個(gè)其他本機(jī)庫(kù)(其實(shí)就是將這些庫(kù)鏈接起來(lái),不然不能調(diào)方法)
target_link_libraries( # Specifies the target library.
                       ${LIBRARY_NAME}

                       # Links the log library to the target library.
                       ${log-lib} )
image.png
3.在app目錄下的build.gradle中添加以下代碼
android {
   ...
    defaultConfig {
        ...
        externalNativeBuild {
            cmake {
                cppFlags ''
            }
        }
    }
    ...
    externalNativeBuild {
        cmake {
            path file('src/main/cpp/CMakeLists.txt')
            version '3.10.2'
        }
    }
    ndkVersion "16.1.4479499"
}

ndkVersion "16.1.4479499" 指定ndk的版本,可以改成你需要的版本

4.在cpp目錄下新建temp.cpp和temp.h并在CMakeLists.txt的add_library中添加
image.png

image.png

cpp文件可添加多個(gè),如下:


image.png
5.在需要使用的地方先loadLibrary,然后定義jni方法
class MainActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)
    }

    private external fun stringFromJNI(): String
    companion object {
        init {
            System.loadLibrary("parser")
        }
    }
}

在stringFromJNI方法上使用快捷提示option+enter (Mac os),并選擇Create Jni function


image.png

然后會(huì)在temp.cpp中會(huì)自動(dòng)創(chuàng)建對(duì)應(yīng)的方法,如下


image.png

TODO位置就可以寫(xiě)c++代碼
使用libmobi庫(kù)請(qǐng)直接看第三部分

二、在新建項(xiàng)目中添加

File->new->new Project,選擇Native C++,然后next->finish


image.png

這樣就直接完成了,IDE會(huì)直接幫你創(chuàng)建一個(gè)native-lib.cpp


image.png

如果要指定ndk版本,如下

android {
  ...
  externalNativeBuild {
        cmake {
            path file('src/main/cpp/CMakeLists.txt')
            version '3.10.2'
        }
    }
    ndkVersion "16.1.4479499"
}

三、使用libmobi庫(kù)

1.進(jìn)入libmobi GitHub倉(cāng)庫(kù)libmobi
2.復(fù)制libmobi中src目錄下所有文件
3.在自己的項(xiàng)目的cpp文件夾下新建libmobi文件夾并粘貼剛才復(fù)制的所有文件
image.png
4.在CMakeLists.txt中添加
image.png

由于libmobi使用了NDK的zlib,所以需要在CMakeLists.txt有如下修改


image.png
5.在temp.cpp的jni方法里寫(xiě)c++代碼調(diào)用libmobi的解析方法
extern "C" JNIEXPORT jstring JNICALL
Java_com_test_temp_MainActivity_stringFromJNI(JNIEnv *env, jobject thiz) {
    jstring file_path = (jstring) "you_file_path";
    jstring parser_out_path = (jstring)"parser_out_path";
    //parserMobi方法是從mobitool.c的loadfilename(const char *fullpath)中拷貝的
    return parserMobi(env, Jstring2CStr(env, file_path),parser_out_path);
}

Jstring2CStr方法放在最后了
parserMobi()就是自定義解析mobi格式文件的方法,方法的具體代碼比較多就不發(fā)了,這個(gè)方法的主要邏輯是從libmobi的tools文件夾下的mobitool.c中的loadfilename(const char *fullpath)方法中拷貝的,具體的解析方法可以看mobitool.c的main(int argc, char *argv[])方法,例如main方法有如下的介紹:

image.png

mobitool.c本身就是一個(gè)命令行工具,每個(gè)參數(shù)都有自己的作用,根據(jù)自己的需求找到對(duì)應(yīng)參數(shù)在mian方法中的處理然后參考。例如’-s‘就是解析源文件,到mobitool.c的main方法找到如下代碼

/**
 @brief Main
 */
int main(int argc, char *argv[]) {
    ...
    int c;
    while((c = getopt(argc, argv, "cd" PRINT_EPUB_ARG "imo:" PRINT_ENC_ARG "rs" PRINT_RUSAGE_ARG "vx7")) != -1)
        switch(c) {
            ...
            case 'r':
                dump_rec_opt = 1;
                break;
            case 's':
                dump_parts_opt = 1;
                break;
            ...
            default:
                exit_with_usage(argv[0]);
        }
    ...
    ret = loadfilename(filename);
    ...
    return ret;
}

可知是將dump_parts_opt賦值為1,最后執(zhí)行了loadfilename(filename)方法,再到loadfilename方法中找到dump_parts_opt相關(guān)的地方

/**
 @brief Main routine that calls optional subroutines
 @param[in] fullpath Full file path
 */
int loadfilename(const char *fullpath) {
    ...
    } else if (dump_parts_opt || create_epub_opt) {
        printf("\nReconstructing source resources...\n");
        /* Initialize MOBIRawml structure */
        /* This structure will be filled with parsed records data */
        MOBIRawml *rawml = mobi_init_rawml(m);
        if (rawml == NULL) {
            printf("Memory allocation failed\n");
            mobi_free(m);
            return ERROR;
        }

        /* Parse rawml text and other data held in MOBIData structure into MOBIRawml structure */
        mobi_ret = mobi_parse_rawml(rawml, m);
        if (mobi_ret != MOBI_SUCCESS) {
            printf("Parsing rawml failed (%s)\n", libmobi_msg(mobi_ret));
            mobi_free(m);
            mobi_free_rawml(rawml);
            return ERROR;
        }
        if (create_epub_opt && !dump_parts_opt) {
        ...
        } else {
            printf("\nDumping resources...\n");
            /* Save parts to files */
            ret = dump_rawml_parts(rawml, fullpath);
            if (ret != SUCCESS) {
                printf("Dumping parts failed\n");
            }
        }
       /* Free MOBIRawml structure */
        mobi_free_rawml(rawml);
    }
    ...
    return ret;
}

代碼比較長(zhǎng)大部分都省略了,關(guān)鍵就在這兩個(gè)if判斷時(shí)根據(jù)dump_parts_opt值做了什么邏輯,然后就可以參考這部分代碼自定義自己的解析方法,(是不是可以考慮將整個(gè)mobitool.c拷貝到項(xiàng)目,然后將main方法改造成可調(diào)用的方法?注:不修改是不行的,有main方法的話(huà)無(wú)法編譯)

Jstring2CStr方法

char *Jstring2CStr(JNIEnv *env, jstring jstr) {
    char *rtn = NULL;
    jclass clsstring = env->FindClass("java/lang/String");
    jstring strencode = env->NewStringUTF("GB2312");
    jmethodID mid = env->GetMethodID(clsstring, "getBytes", "(Ljava/lang/String;)[B");
    jbyteArray barr = (jbyteArray) env->CallObjectMethod(jstr, mid, strencode);
    jsize alen = env->GetArrayLength(barr);
    jbyte *ba = env->GetByteArrayElements(barr, JNI_FALSE);
    if (alen > 0) {
        rtn = (char *) malloc(alen + 1); //new char[alen+1];
        memcpy(rtn, ba, alen);
        rtn[alen] = 0;
    }
    env->ReleaseByteArrayElements(barr, ba, 0);
    return rtn;
}
最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成,瀏覽時(shí)請(qǐng)結(jié)合常識(shí)與多方信息審慎甄別。
平臺(tái)聲明:文章內(nèi)容(如有圖片或視頻亦包括在內(nèi))由作者上傳并發(fā)布,文章內(nèi)容僅代表作者本人觀點(diǎn),簡(jiǎn)書(shū)系信息發(fā)布平臺(tái),僅提供信息存儲(chǔ)服務(wù)。

相關(guān)閱讀更多精彩內(nèi)容

友情鏈接更多精彩內(nèi)容