如何在Eclipse CDT/CMake上編程Android C/C++ 原生程式 (適用Android P以上）

-

前言

對Android App的應用開發者而言，用C/C++開發，就使用Android Studio已提供C/C++/JNI的編程功能就足夠了。但是對於Android Studio所提供的C/C++編程功能並無法完全滿足Android平台開發人員在進行以C/C++編寫的平台原生服務（Native Service）。所以原生服務例如：netd、surfaceflinger或甚至init。

本文是說明如果利用Eclipse匯入Android的原生代碼（Native C/C++ Code），並且直接在Eclipse可以瀏灠、修改及編譯C/C++原生代碼以提升Android平台工程式的效率。
由於Android平台工程師主要的工作環境是Ubuntu，所以我們選擇的套件為：
期望可以得到的功能是：

  • 在Eclipse成功編譯可在Android上執行的程式
  • 可載入Android原生Project，並且在Eclipse進行編寫、索引、編譯甚至除錯的完整功能





為何選擇Eclipse

Eclipse應該不用做太多介紹。它算是目前在跨平台、免費的IDE中最受歡迎之一的軟體。從Eclipse一開始，就以核心服務＋插件的基礎架構上，Eclipse吸引了大批的開發人員在Eclipse平台上進行各式插件開發。十幾年發展下來，Eclipse幾乎跨越了所有編程上的語言，只是成熟度上有所不同（這也直接導致當時IDE的軟體商幾乎賺不到錢了，紛紛消失或賣掉了，且讓我們懷念一下Borland！而很多當時開源的IDE，也逐漸退出，直到VSCode的出現，才又有了一個開源又好用的IDE！）。Eclipse編程工具中，最成熟的是Java，且C/C++的成熟度也是很高。

之所以選擇Eclipse做為開發Android原生服務C/C++的原因，主要還是經過一些比較後決定：

  • Eclipse CDT (C/C++ Development Tool）經長期開發，比起其他工具，相對穩定好用，功能齊全
  • Eclipse CMake支援，讓撰寫跨平台編譯文本（類似Makefile）變得容易上手。
  • Eclipse CMake支援Indexer，可進行靜態語法分析，精確度遠勝Source Insight。而且CDT Indexer支援C++14/17的語法，像是lambda語法。

安裝Eclipse CDT/Cmake及第一個“Hello World!" C++專案


安裝Eclipse 2016-06（Ubuntu Desktop 18.04 64bit）

本文發佈時（2019/6/30）最新的Eclipse穩定版本為2019-06版，那就選擇它吧！
請先確認JDK 8已安裝，因為Eclipse是
到 https://www.eclipse.org/downloads/

Eclipse 2019-06版下載頁面

點擊「Download 64 bit」進入下載連結
從最近的mirror site下載Eclipse Installer

再點擊「Download」，開始進行下載。

下載完成後，解壓縮後，在該目錄下，可以看到eclipse-inst，如圖所示：
解壓縮後目錄內容
雙擊eclipse-inst，執行安裝程式。跳出Eclipse安裝程式：

Eclipse for C/C++ Developers

點擊「Eclipse IDE for C/C++ Developers」後，再按下「Install」並接受License/Certifictions之後，就開始下載並安裝。安裝完成後，點擊「Launch」，則開啟Eclipse。


安裝Eclipse CMake 

安裝Eclipse CMake Plugin，讓CDT可以使用CMakeList.txt作為Build Script。
在Eclipse中，點擊 [Help->Eclipse Marketplace...]



跳出Eclipse Market視窗後，在Find:文字欄中輸入CMake，並且按下右方的「GO」按鈕。
顯示出CMake相關的插件我們需要：

  • cmake4eclipse 1.14.0
  • CMake Editor 1.11.0

分別安裝（按下各插件右下方的Install），安裝這兩個插件。接受License，開始安裝作業。
安裝完成後重新啟動Eclipse。

事實上CDT也開始自己的CMake Plug-in的支援，目前仍在Preview版本。基本上在使用Linux上標準GCC時支援度不錯，但在Cross Compile時的CDT Index判斷就出現問題。所以目前仍選擇使用cmake4eclipse。

第一個CMake Project

在Eclipse中，點擊 [File->New->C/C++ Project]
開啟CDT C/C++ Project
開啟Projects視窗後，選擇CMake Project


之後輸入Project Name，例如「helloworld」，然後按下「Finish」。則成功建立一個CMake Project。
按下Eclipse左上角工具列的第一個按鈕，則開始進行Project Build，結果如下圖：


可以看到左上角的槌子圖示就是Build，再右邊圖示是執行，最後再右邊圖示是停止執行。
Build成功後即可執行。如果發生錯誤有可能是沒安裝cmake或ninja命令套件。

sudo apt install cmake
sudo apt install ninja-build

執行後應該就能在Console View (底部的視窗，有個Console，除了顯示Build的過程，也會顯示執行結果）。

Eclipse和Android AOSP整合

接下來就是重頭戲了。如果只是單純推廣Eclipse CDT/CMake倒是沒什麼Know-How（雖然網路上好像沒找不到這方面的文章），那這文章也不必特別寫了。我們的目的主要還是要讓Eclipse成為開發Android平台的好工具。在使用Eclipse修改Android原生C/C++之前，我們還是先滙入一個全新簡單的C/C++專案來做為入門課程，比較容易上手。

我已經完成一個簡單的GitHub專案，可用來做初步的教程。

Hello World! 在Android上執行

先關閉Eclipse。因為在進入Eclipse之前要先把Android Build System的環境變數設定完成，這些環境變數在之後我們用的CMakeLists.txt會用到。之所以要使用到Android Build System的環境變數，主要是確保我們的CMakeLists.txt的相容性和可移植性。

首先進入你的Android Codebase，並且確認你已完成環境設定，而且必須確認整個Codebase已經Build過了，以AOSP Pixel2為例：
sh. ./build/envsetup.sh 
lunch aosp_walleye-userdebug
make -j16

確保我們的環境變數都設定完成，接下來開啟Eclipse。重新開啟一次是確認Eclipse都取得AOSP的環境變數，以利於我們之後取得Android的C/C++ Compiler路徑。

此時取得在GitHub中的第一個Sample。這個Sample已存在GitHub，我們可以直接用Eclipse取出來。

滙入Sample Project: helloworld !

在Eclipse下選擇「File-->Import」

用Eclipse滙入GitHub中的

選擇「Projects from Git」，按下「Next>」

選擇「Clone URI」，按下「Next>」



在URI中輸入「https://github.com/c55jeremy/android-cmake」，其他欄位會自動填好，按下「Next>」，之後一直「Next>」到「Finish」則完成滙入。如下圖：


按下「Finish」完成滙入。
按下來就是按下左上角的Build Icon（鎚子圖示）


完成編輯後，在android-cmake刷新（F5），會看到CMake產生出來兩個Targets：hellworld及libmyfunc.so。把它們推入手機中即可執行。

執行helloworld

Eclipse預設滙入Git Project存放在~/git（除非剛剛的匯入過程中，你有更動）。
所以android-cmake這個Project Build出來的Targets (helloworld及libmyfunc.so）就放在~/git/android-cmake/build/Debug下。
開啟Terminal，用adb將這兩個檔案推入：

adb root
restarting adbd as root
adb remount
remount succeeded
adb push helloworld /system/bin
helloworld: 1 file pushed. 2.4 MB/s (92368 bytes in 0.037s)
adb push libmyfunc.so /system/lib64
libmyfunc.so: 1 file pushed. 4.1 MB/s (71832 bytes in 0.017s)
adb shell helloworld 
16 2 77 29 
Hello Android! Hello! myfunc
999

最後產生的Output (10~12行)，就是我們在android-cmake的main.cpp/myfunc.c的程式碼輸出結果。這可以證明我們在外部產生一個可執行檔，並且使它連結動態函式庫，完成結果。

之後如果仍需要開發其他的Android Native Program，就直接Copy/Paste這個Project以建立新的Project並進行修改即可。

待續...

之後會在補上：
1. CMakeLists.txt的解釋。
2. 如果不使用滙入，如何逐步建立自己的Eclipse/CMake Project。

結論

Eclipse/CMake目前在完整度上完全可以符合Android平台工程師在看Native Code的需求，但目前仍未把Android的原生碼滙入，所以之後我會再解釋如何把Android原生服務的Project匯入，以整合成一個完整的Android平台開發環境。




留言

  1. fatalfeel2020年4月4日 晚上9:21

    android studio eclipse debug c++ on ndk-v20b
    http://fatalfeel.blogspot.com/2013/10/android-studio-with-eclipse-debug-jni.html

    回覆刪除

張貼留言

這個網誌中的熱門文章

完整指引如何編譯AOSP (Build Android P)，整合GMS及刷機 (Pixel 2)

-
圖片
前言 本文是說明一個Android Framework研發人員，如何利用Google的Pixel手機進行系統程式的客製化。本文的工作如下： 解鎖Pixel2 取得AOSP原始碼 編譯AOSP （Build AOSP） 將Pixel 2刷機自己編譯的ROM 修改Framework後，重編譯，再刷機，完成！ 安裝GMS 本文針對Pixel 2進行刷機，理論上Pixel2 XL/Pixel 3/Pixel 3 XL應該都適用。 前置工作 解鎖Pixel 2，讓手機允許刷機 首先必須知道，官方釋出的手機的開機載入程序（Bootloader）會阻止你刷入任何客製ROM。所以所謂「解鎖」就是解鎖Bootloader，讓它允許你可以進行刷機動作。 其次要注意是在刷機後，所有使用者資料（User data）都會消失。所以刷機前要先備份重要資料。 網路上有很多教解鎖Pixel手機的文章，都可以參考，實際上在Android官網已經有教導你如何解鎖Pixel 2的Bootloader，我個人是比較習慣直接看官網來做： https://source.android.com/setup/build/running 如果你懶得看一大堆英文，根據官網的描述，以下的命令就可以讓你解鎖Bootloader。 adb reboot bootloader #等重開機後會看到一個躺著且肚子打開的機器人 fastboot flashing unlock #進入清除資料階段，螢幕顯示Erasing data... 所以解鎖其實只有兩個命令： 1. adb reboot bootloader重開機以進入“開機載入程序”，畫面如下 adb reboot bootloader後的實機畫面
閱讀完整內容

架設Gerrit Server : 架設本地AOSP Gerrit Server完整指引 PART1

-
圖片
前言 本文引導入如何從無至有，建立一個專屬自己的Gerrit伺服器 (Gerrit Server) 本文是系列文的第一篇，本系列在介紹如何建立本地自有 （localhost） Gerrit Server並且將AOSP （Android Open Source Project）的原始碼完整導入此Gerrit Server。 文章分為三個部份，本文是第一部份，教導如何架設Gerrit Server，如果你已經很熟悉這個工作，可以直接跳至第二或第三部份。 第一部份：架設Gerrit Server （本文） 第二部份： 移轉整個AOSP至本地Gerrit Server 。 第三部份： 如何從本地Gerrit Server建立一個AOSP Branch ， 真正利用Gerrit來確保Code的品質並且保留企業內部技術。 進行此AOSP導入工作的主要目的在於本人專業工作上需要修改AOSP原始碼以符合客製化的需求，但AOSP本身龐大的原始碼及代碼庫（Repository）不適合再導入公司內部原有已存在的Gerrit Server。於是乎，將AOSP導入一個新建的Gerrit Server成為一個合理的選擇。另外更重要的原因是，自身內部專案的AOSP原始碼必須能夠提供以下功能： 進行Code Review，確保穩定性及紀錄留存以保留技術知識。 同步Merge Android官方原始碼，確保官方修正的問題可以同步合入自身專案。 在完成本文系統的三篇文章中所述的任務之後，你應該可以： 建立基本Gerrit Server的能力 抓取AOSP並導入自有Gerrit Server的能力 同步AOSP並且合入官方修改的原始碼的能力 建立自身AOSP Branch並且修改及進行Code Review 本文在Ubuntu 18.04進行，基本上我在Ubuntu 16.04也執行過同樣任務，所以差別不大，所以你的系統是在Ubuntu 16.04，應該完全可以適用。 所需軟體 Gerrit (version 2.16.4) Git Open JDK 8 MySQL (非必要） Gerrit Delete Project Plug-in （非必要，但很好用） 安裝及設定 因為Gerrit是以Java開發，而且AOS...
閱讀完整內容

將AOSP加入Gerrit Server : 架設本地AOSP Gerrit Server完整指引 PART2

-
圖片
前言 本文在引導你如何將AOSP （Android Open Source Project）完整導入企業內部或個人Gerrit伺服器。AOSP包含近800個專案，要如何有效快速無誤的將這些專案導入Gerrit對很多IT人員來說若不知方法會是很頭痛的問題。 本文是系列文的第二篇，本系列在介紹如何建立本地自有 （local host） Gerrit Server並且將AOSP （Android Open Source Project）的原始碼完整導入此Gerrit Server。 系列分為三個部份，本文是第二部份，教導如何建立AOSP Git Mirror並且同步導入自建的Gerrit Server，如果你還不知如何架設一個Gerrit Server，可以回到這系列的 第一部份： 架設Gerrit Server ， 第二部份：將AOSP完整導入Gerrit Server (本文）。 第三部份： 如何從本地Gerrit Server建立一個AOSP Branch 。 進行此AOSP導入工作的主要目的在於本人專業工作上需要修改AOSP原始碼以符合客製化的需求，但AOSP本身龐大的原始碼及代碼庫（Repository）不適合再導入公司內部原有已存在的Gerrit Server。於是乎，將AOSP導入一個新建的Gerrit Server成為一個合理的選擇。另外更重要的原因是，自身內部專案的AOSP原始碼必須能夠提供以下功能： 進行Code Review，確保穩定性及紀錄留存以保留技術知識。 同步Merge Android官方原始碼，確保官方修正的問題可以同步合入自身專案。 在完成本文中所述的任務之後，你應該可以： 建立基本Gerrit Server的能力 抓取AOSP並導入Gerrit Server的能力 同步AOSP並且合入官方修改的原始碼的能力 建立自身AOSP Branch並且修改及進行Code Review 本文在Ubuntu 18.04進行，基本上我在Ubuntu 16.04也執行過同樣任務，所以差別不大，所以你的系統是在Ubuntu 16.04，應該完全可以適用。 所需軟體 Gerrit  (version 2.16.4) Git Open JDK 8 Apache2 （非必要） MyS...
閱讀完整內容