Android使用C語言庫入門

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

一、在已有項目中添加

1.在項目的app(或module)目錄下的src/main新建cpp文件夾(在java同級)
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.

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

#設(shè)置要編譯的庫
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中的庫
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ī)庫鏈接到一個或多個其他本機(jī)庫(其實就是將這些庫鏈接起來,不然不能調(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文件可添加多個,如下:


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

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


image.png

TODO位置就可以寫c++代碼
使用libmobi庫請直接看第三部分

二、在新建項目中添加

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


image.png

這樣就直接完成了,IDE會直接幫你創(chuàng)建一個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庫

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

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


image.png
5.在temp.cpp的jni方法里寫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ā)了,這個方法的主要邏輯是從libmobi的tools文件夾下的mobitool.c中的loadfilename(const char *fullpath)方法中拷貝的,具體的解析方法可以看mobitool.c的main(int argc, char *argv[])方法,例如main方法有如下的介紹:

image.png

mobitool.c本身就是一個命令行工具,每個參數(shù)都有自己的作用,根據(jù)自己的需求找到對應(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;
}

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

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)容合作請聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成,瀏覽時請結(jié)合常識與多方信息審慎甄別。
平臺聲明:文章內(nèi)容(如有圖片或視頻亦包括在內(nèi))由作者上傳并發(fā)布,文章內(nèi)容僅代表作者本人觀點,簡書系信息發(fā)布平臺,僅提供信息存儲服務(wù)。

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

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