android 串口開發第一篇:搭建ndk開發環境以及第一個jni調用程式

一：ndk環境搭建

     1:開發環境

　　我使用的是android studio 2.3.3版本，搭建ndk開發環境比較簡單，打開File----Settings----Appearance&Behavior----System  Settings----Android SDK，選擇SDK Tools,將CMake,LLDB,NDK 前的覆選框勾上，點擊Apply，然後就是等待ndk下載完成。

　　安裝成功後,右鍵項目----open  module setting，Android NDK location會自動賦值

 二：第一個jni程式

     1:創建ndk項目

      創建ndk項目和普通android項目有一點區別，需要把Include C++ support前面的覆選框勾上，然後直接下一步。但在最後一步，有一個c++下拉框選項，可以根據你的實際情況適當修改，C++ Standard ：點擊下拉框，可以選擇標準 C++，或者選擇預設 CMake 設置的 Toolchain Default 選項。Exceptions Support ：如果你想使用有關 C++ 異常處理的支持，就勾選它。勾選之後，Android Studio 會在 module 層的 build.gradle 文件中的 cppFlags 中添加 -fexcetions 標誌。Runtime Type Information Support ：如果你想支持 RTTI，那麼就勾選它。勾選之後，Android Studio 會在 module 層的 build.gradle 文件中的 cppFlags 中添加 -frtti 標誌。

     項目創建好後，app下多了一個cpp目錄，該目錄用於存放c程式的源碼，頭文件，預編譯項目等，android studio 會預設幫我們創建一個native-lib.cpp文件，該文件已有一個測試方法，結構圖如下:

      通過上圖看到，在External Build Files 下麵多了一個CMakeLists.txt文件，該文件用於c程式需要生成so文件的配置文件。

　　cmake_minimum_required(VERSION 3.4.1):這是版本信息，我們不用管它

　　add_library（）：這個命令是，通過add.library()定義多個庫,CMake會去自動構建他們，一個*.cpp文件對應一個add_library命令.

add_library( # Sets the name of the library.生成so文件的名字，建議和cpp文件同名
             native-lib

             # Sets the library as a shared library.
             SHARED

             # Provides a relative path to your source file(s). 需要生成so文件的cpp文件名稱
             src/main/cpp/native-lib.cpp )

　　find_library():定位 NDK library 的位置，並將其位置存儲在一個變數之中。在構建腳本的其他地方使用這個變數，來代指 NDK library。下麵的示例代碼將 Android-specific log support library 的位置存儲到變數 log-lib 中

find_library( # Sets the name of the path variable.
              log-lib

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

　　現在我們來看native-lib.cpp文件，這是as幫我們自動生成好的，返回是一個Hello from C++的字元串。

#include <jni.h>
#include <string>

extern "C"
JNIEXPORT jstring JNICALL
Java_serialport_com_ndkjnidemo_MainActivity_stringFromJNI(
        JNIEnv* env,
        jobject      /* this */) {
    std::string hello = "Hello from C++";
    return env->NewStringUTF(hello.c_str());
}

    JNIEXPORT jstring JNICALL 這裡的jstring代表返回值, 參數JNIEnv* env,代表指針，jobject 代表調用這個方法的對像,方法命名規則：Java_包名_調用jni方法的類名_方法名,android studio 幫我們
生成的程式，activity包名是serialport.com.ndkjnidemo,類名是MainActivity,方法名是stringFromJNI，所以native-lib.cpp方法名稱為：Java_serialport_com_ndkjnidemo_MainActivity_stringFromJNI,其中返回值類型和java數據類型對應如下

    如果我們需要寫多個jni方法，*.cpp格式如下：

//方法一
extern "C"
JNIEXPORT jstring JNICALL
Java_serialport_com_ndkjnidemo_MainActivity_test1(
        JNIEnv* env,
        jobject /* this */) {
    std::string hello = "Hello from C++";
    return env->NewStringUTF(hello.c_str());
}
//方法二

extern "C"//如果不寫extern "C"  java是無法調用到這裡定義的方法
JNIEXPORT jstring JNICALL
Java_serialport_com_ndkjnidemo_MainActivity_test2(
        JNIEnv* env,
        jobject /* this */) {
    std::string hello = "Hello from C++";
    return env->NewStringUTF(hello.c_str());
}

　　最後我們來看自動生成的MainActivity,在onCreate中調用stringFromJNI，然後給文本組件賦值，軟體運行參見圖一

package serialport.com.ndkjnidemo;
import android.support.v7.app.AppCompatActivity;
import android.os.Bundle;
import android.widget.TextView;
public class MainActivity extends AppCompatActivity {

static {
　　　　//native-lib值來自，CMakeLists.txt文件中，add_library命令的第一個參數
        System.loadLibrary("native-lib");
    }

protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);
    TextView tv = (TextView) findViewById(R.id.sample_text);
    tv.setText(stringFromJNI());
}

public native String stringFromJNI();

}

代碼都是android studio自動自成的，所以此處不上傳代碼，demo運行結果：　　

參考文章：

Android NDK 開發（五）AndroidStudio 2.2 NDK的開發環境搭建

一天掌握Android JNI本地編程 快速入門