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 代表調用這個方法的對像（普通方法是jobject,靜態方法是jclass）后面的參數和java類中定義的本地方法對數相對應,方法命名規則：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本地編程 快速入門