2013年6月21日 星期五

Android NDK 使用C++與 STL(Standard Template Library)

最近有一份使用STL的c++ code要port到android上面, 最後決定採用NDK而不改寫成java

一點點筆記:

就算code都是用c style寫的, 但只要用了STL之類的c++ library就要視為c++處理, 以下是編譯步驟.

1. 和往常一樣在project之中建立jni資料夾, 關鍵是資料夾中的c++檔案要以.cpp附檔名,

如此一來使用ndk-build script的時候就會自動選用c++的compiler來編譯. 不然build的時候會先遇到找不到header的error. 因為c++ compiler和c compiler 的搜尋header路徑不同.

2. 建立Android.mk在jni資料夾中, 內容大概像這樣

LOCAL_PATH := $(call my-dir) include $(CLEAR_VARS) LOCAL_MODULE := temp_jni LOCAL_SRC_FILES := test.cpp LOCAL_LDLIBS := -llog include $(BUILD_SHARED_LIBRARY)


include $(CLEAR_VARS) -> 開始一段全新乾淨的編譯

LOCAL_MODULE := temp_jni -> 指定編出來的library名稱, 這樣會編出 libtemp_jni.so

LOCAL_SRC_FILES := test.cpp -> 當然就是要編譯的source file了

LOCAL_LDLIBS := -llog -> 在這邊我們多link一個log的library之後debug用,不是必須但是很方便,等等介紹怎麼用.

include $(BUILD_SHARED_LIBRARY) -> 最後呼叫Android負責編譯shared library的script開始編譯

3(Optional). 使用liblog.so的print log debug 功能: (即上述LOCAL_LDLIBS := -llog)

在.cpp source file內加入以下內容


#define LOG_TAG "TEST_JNI" #define LOGI(...) __android_log_print(ANDROID_LOG_INFO,LOG_TAG,__VA_ARGS__) #define LOGE(...) __android_log_print(ANDROID_LOG_ERROR,LOG_TAG,__VA_ARGS__)


之後只要在c++ Code中使用 LOGE("hello world");就可以像在android java program 中使用Log.e(LOG_TAG,"hello world")一樣印log在logcat中! 同理LOGI,LOGV等.


4.在jni資料夾下建立一個Application.mk檔案, 內容如下面一行

APP_STL := stlport_static

目的是這樣的, 因為Android NDK預設只會link一份最簡陋的STL, 但其實NDK中有還是有放一份完整的STL, 所以要告訴編譯器編譯時去使用這份完整的STL.

附帶一提APP_STL的值有以下四種:
system -->預設,簡陋
stlport_static
stlport_shared
gnustl_static

5. 寫一個使用STL的 .cpp file吧!
像這樣

#include <vector> #include <jni.h> #include <android/log.h> //見第3點 #define LOG_TAG "FEATRUEEXTRACTION" #define LOGI(...) __android_log_print(ANDROID_LOG_INFO,LOG_TAG,__VA_ARGS__) #define LOGE(...) __android_log_print(ANDROID_LOG_ERROR,LOG_TAG,__VA_ARGS__) using namespace std; void runTest(const char* in) { vector<const char*> tt; tt.push_back("hello"); tt.push_back("world"); tt.push_back(in); LOGE(tt[2]);//會在logcat中印出從java端呼叫JNITestFunction時所傳入的String } extern "C"{ //注意 void Java_com_example_temp_MainActivity_JNITestFunction( JNIEnv* env, jobject thiz , jstring inString) { //should be released const char *in = (env)->GetStringUTFChars(inString,0); runTest(in); } } //注意


有兩點要特別注意:

一,一定要用extren "C"{}包住jni function,不然runtime會找不到這個jni function.

二,使用C++的時候jni.h的function會被一層wrapper包住,所以呼叫的方法和使用c的時候不一樣,

如上面使用GetStringUTFChars function 在c的版本會是這樣使用:
(*env)->GetStringUTFChars(env,inString,0); 

細節只要去NDK的platforms/android-(隨便一個版本)/arch-arm/usr/included/jni.h中看就瞭解.

6.java的部分大概長這樣
package com.example.temp; import android.os.Bundle; import android.app.Activity; import android.view.Menu; public class MainActivity extends Activity { public static native void JNITestFunction(String inString); static { System.loadLibrary("temp_jni"); } @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_main); JNITestFunction("cyy"); } @Override public boolean onCreateOptionsMenu(Menu menu) { // Inflate the menu; this adds items to the action bar if it is present. getMenuInflater().inflate(R.menu.activity_main, menu); return true; } }
7.切換目錄到jni/下面使用 <NDKROOT>/ndk-build 指令.

這樣會編出shared library. 這些編出來的library之後會被包進.apk中一併燒進手機中

8. 在Eclipse中像平常一樣執行這個app, 搞定收工!



2013年6月18日 星期二

ios project中使用STL(Standard Template Library)

ios中使用c: 直接用

ios中使用c++,STL:

因為STL是c++的library所以直接編譯含有STL的code會發生找不到header之類的問題.

古早一點版本的x code似乎需要手動去設定編譯使使用c++的compiler.

但現在只要將reference到 c++ code的檔案副檔名從.m改成.mm, 則編譯的時候會自動使用c++ compiler來處理,並且STL header等c++的header也會被加入搜尋路徑, 相當方便!

舉個例子, 我有foo.h foo.cpp main.m,

則直接在main.m中 import foo.h並且把檔名改成main.mm就搞定了!




2013年6月15日 星期六

Android app的status bar高度

status bar就是android手機最上面那一條有顯示電量與時間的bar,

為了寫一個可以在不同size螢幕上面都能按照同比例顯示view的layout需要得到status bar的高度來幫助計算.

一開始google都是找到類似如下的答案

Rect rectgle= new Rect();
Window window= getWindow();
window.getDecorView().getWindowVisibleDisplayFrame(rectgle);
int StatusBarHeight= rectgle.top;
int contentViewTop= 
    window.findViewById(Window.ID_ANDROID_CONTENT).getTop();
int TitleBarHeight= contentViewTop - StatusBarHeight;

   Log.i("*** Jorgesys :: ", "StatusBar Height= " + StatusBarHeight + " , TitleBar Height = " + TitleBarHeight);
( from http://stackoverflow.com/questions/3355367/height-of-statusbar/3356263#3356263)

雖然這樣可以拿到我要的status bar高度, 但是有一個大缺點, 就是這個方法要等到整個畫面被畫出來以後才根據畫出來的結果來計算status bar高度.

偏偏android的life cycle中, 畫面被畫出來是在onCreate(), onResume(), onRestart()等步驟之後,

所以在這些override function內是不能拿到正確的status bar heigth的!!

很不方便.

直到最近偶然發現了更好的方法:

public int getStatusBarHeight() { int result = 0; int resourceId = getResources().getIdentifier("status_bar_height", "dimen", "android"); if (resourceId > 0) { result = getResources().getDimensionPixelSize(resourceId); } return result; }

from http://mrtn.me/blog/2012/03/17/get-the-height-of-the-status-bar-in-android/

真是太猛了這樣一來就可以在onCreate()等處得到status bar的高度,

Comments中還有提到

<sdk-root>/platforms/android-<version>/data/res/values/dimens.xml

內還有一堆參數也都拿的到啊!!!