在Android 2.3中如何使用native_activity.h编写本地应用

现在，在Android2.3版本里，可以使用native_activity.h接口实现一个完整的native activity，在使用的时候，要确认回调函数不能阻塞主UI线程。更多信息，可以参考<ndk_root>/platforms/android-9/arch-arm/usr/include/android/native_activity.h.

Native_app_glue静态辅助库为另一个线程中的事件循环提供了回调，而且非常容易使用，可以参考native-activity示例程序。下面是利用native_activity.h实现native activity程序的步骤：

 

  1/ 在Eclipse中创建一个android项目，在项目的根目录下新建一个jni目录用于存放所有的本地代码。

  2/ 按如下示例在AndroidManifest.xml文件中声明本地的activity

      <manifest xmlns:android="http://schemas.android.com/apk/res/android"

        package="com.example.native_activity"

        android:versionCode="1"

        android:versionName="1.0"> 

       

        <uses-sdk android:minSdkVersion="8" />

       

        <application android:label="@string/app_name" android:hasCode="false">

       

          <activity android:name="android.app.NativeActivity"

            android:label="@string/app_name"

            android:configChanges="orientation|keyboardHidden">

       

          <meta-data android:name="android.app.lib_name"

            android:value="native-activity" />

            <intent-filter>

              <action android:name="android.intent.action.MAIN" />

              <category android:name="android.intent.category.LAUNCHER" />

            </intent-filter>

          </activity>

        </application>

      </manifest>

 

    主要的内容包括:

 

      - activity标签的android:name 属性必须设成android.app.NativeActivity.

      - meta-data标签的android:name 属性必须设成 android.app.lib_name， lib_name没有模块的lib前缀和.so后缀.

 

  3/创建文件实现ANativeActivity_onCreate()函数供activity启动时调用。这个函数参数是ANativeActivity结构体指针，包含了指向回调函数的函数指针，这些回调函数需要编程实现，然后为ANativeActivity->callbacks赋值

 

  4/ 为ANativeActivity->instance赋值为需要用到的数据地址

 

  5/ 实现在activity启动前需要做的其他事情

 

  6/ 实现在ANativeActivity->callbacks中设置的其他回调函数. 这些回调函数的调用时机可以参看Activity的SDK文档。需要注意的是这些实现不能阻塞，否则可能在运行时主线程会收到ANR（应用程序无响应）的错误。

 

  7/ 开发应用程序功能

   

  8/ 在jni目录创建一个Android.mk文件来描述本地代码的编译器选项，本质上这个文件就是GNU Make文件的一部分。例如:

      

       LOCAL_PATH := $(call my-dir)

       include $(CLEAR_VARS)

       LOCAL_MODULE    := my_native_module

       LOCAL_SRC_FILES := my_native_code.c

       include $(BUILD_SHARED_LIBRARY)

 

     怎样创建和具体的含义参见<ndk_root>/docs/ANDROID-MK.TXT文件。

    

  9/ 一旦有了Android.mk文件，就可以使用”ndk-build”命令编译代码了。

    

       cd path/to/project

       <ndk_root>/ndk-build

 

 10/ 与常规应用一样，使用Ant或Eclipse，会自动将jni目录中的本地代码打包到.apk文件中。