Android 開發者代碼實驗室

您可以幫助開發地球歷史上安裝最廣泛的操作系統。是的,您是來踏上成為 Android 平台工程師的旅程的。

儘管這條道路充滿挑戰,但 Android 團隊努力簡化您的每一個版本的旅程。該團隊每天都通過在 Android 開源項目 (AOSP) 中的直接工作進行改進。

所以坐下來,啟動一個終端,讓我們創造歷史。

目標

這個代碼實驗室的任務有兩個:

  1. 讓您對在該平台(操作系統)上工作的 Android 工程師的開發人員工作流程有所了解。
  2. 鼓勵您提供有關Android 工具、文檔和開發人員工作流程的反饋

先決條件

此 Codelab 的要求列表源自通用平台 ( AOSP ) 開發的要求。要使用此代碼實驗室,請設置以下內容:

環境

通常,用戶直接在工作站上進行構建和開發。因為您可能在不同的終端上工作,並且使用的許多命令都是特定於終端的,所以您需要在每個終端會話中重新運行它們。具體來說,這些包括source build/envsetup.shlunch命令。

設置工作站

  1. 在您的工作站上安裝必要的軟件包
  2. 仍在終端中時,安裝 Repo 並獲取所有 Git 存儲庫的憑據

初始化並同步代碼

  1. 導航到您的主目錄:

    cd ~
    
  2. 在其中創建一個本地工作子目錄:

    mkdir aosp
    
  3. 導航到目錄:

    cd aosp
    
  4. 初始化 AOSP 存儲庫源代碼主分支(默認):

    repo init -u https://android.googlesource.com/platform/manifest
    
  5. 輸入或接受您的 Git 憑據(姓名、電子郵件地址)。

  6. 同步源代碼:

    repo sync -j8
    

初始同步可能需要一個小時或更長時間。等待時請參閱下載說明以了解相關詳細信息。

每個 repo checkout 都由一個清單文件表示。允許一次有 1 個以上的 repo checkout,只要它們存在於不同的目錄中。但請注意,每次結帳和構建的使用量大約為 300 GB(並且還在增長),因此要么將自己限制為 2 次 repo 結帳,要么使用輔助驅動器擴充您的系統。

提示:要釋放空間,請刪除分支目錄並從目錄創建重新開始,如下所示:

rm -rf aosp2

構建代碼

要構建 Android,您必須選擇一個目標設備類型以使用lunch命令構建。目標是設備排列,例如特定型號或外形。

下面的設備包括目標, aosp_cf_x86_64_phone-userdebug ,使您能夠建立墨魚虛擬的Android設備沒有物理設備測試。

要改為構建和更新物理設備,請選擇另一個目標並按照閃存設備的說明進行操作。

  1. 通過從源代碼檢出的根目錄運行以下命令來設置用於構建 Android 設備的環境:

    source build/envsetup.sh
    
  2. 將構建目標傳遞給午餐命令,如下所示:

    lunch aosp_cf_x86_64_phone-userdebug
    
  3. 使用以下命令從結帳中的任何位置構建代碼:

    m
    

預計第一個構建需要幾個小時。後續構建花費的時間要少得多。

創建 Acloud 實例

Acloud是 AOSP 中的一個命令行工具,可幫助用戶創建虛擬 Android 設備,在本例中為 Cuttlefish。

如果您在用於構建代碼的同一個終端會話中,請繼續。否則,重新運行envsetup.sh腳本和您首先在那裡使用的相同的lunch命令。然後

  1. 使用以下命令創建 Acloud 本地實例:

    acloud create --local-image --local-instance
    
  2. 接受對所需軟件包的更新。

  3. 如果出現提示,請重新啟動工作站,以使所有更改生效。

  4. 選擇烏賊設備。

您應該會看到一個包含 Android 設備的 VNC 會話!

您可以使用鼠標和鍵盤與工作站上的虛擬設備進行交互。您還可以在使用設備時通過 Android Debug Bridge (adb) logcat命令跟踪日誌中的活動:

adb logcat

做出改變

按照此示例更改列表更新源代碼。

  1. 從結帳的根目錄( aosp/目錄),導航到frameworks/native Git 項目:

    cd frameworks/native
    
  2. 使用以下命令啟動一個臨時項目:

    repo start <some-name> .
    
  3. 編輯SurfaceFlinger.cpp以在以下位置包含更改列表中的更新:

    aosp/frameworks/native/services/surfaceflinger/SurfaceFlinger.cpp
    

    在您剛剛包含的代碼行下方添加以下內容:

    updateColorMatrixLocked();
    
  4. 構建代碼:

    m
    
  5. 更新設備上的構建:

    adb root
    adb remount
    adb sync
    adb reboot
    acloud reconnect
    

確認您在設備上看到顏色變化。

測試你的代碼

代碼實驗室的這一部分使用了源代碼樹中的一個示例測試,但失敗了。這使用Atest在本地運行測試並測試代碼。

要使用該測試,請按照以下說明操作:

  1. 跑步:

    atest DevCodelabTest
    
  2. 測試將失敗。要修復它,請找到失敗測試的源代碼:

    atest --info android.test.example.devcodelab.DevCodelabTest#testHelloWorld
    
  3. 然後看這裡

    platform_testing/tests/example/devcodelab
    
  4. 要編輯文件,請在android.test.example.devcodelab.DevCodelabTest中獲取測試名稱並替換./ ,得到這個結果:

    src/android/test/example/devcodelab/DevCodelabTest.java
    
  5. 因此,編輯

    platform_testing/tests/example/devcodelab/src/android/test/example/devcodelab/DevCodelabTest.java
    

    取代

    Assert.assertTrue(false)
    

    Assert.assertTrue(true)
    
  6. 再次運行測試以驗證您已修復問題:

    atest DevCodelabTest
    

上傳您的代碼以供審核

Repo 通過捆綁諸如git clone命令來同時處理多個 Git 存儲庫(或項目),從而簡化了 Git 的使用。

有關 Git 和 Repo 的概述,請參閱源代碼控制工具,以及有關使用 Android 源代碼的完整文檔的鏈接。有關 Git 項目的完整列表以及與每個項目關聯的分支的各個項目(路徑),請參閱AOSP 存儲庫

對於 Git 中項目的代碼審查,您將使用Gerrit基於 Web 的代碼審查系統。

  1. 假設您在frameworks/native項目中進行了更改,請運行以下命令以上傳它們:

    cd frameworks/native
    repo start codelab .
    git add .
    git commit
    
  2. 對於您的提交消息,請輸入以下內容:

    Android codelab change
    Test: manual atest
    
  3. 上傳您的更改:

    repo upload
    

如果您成功了,您會看到一條類似於以下內容的消息:

Upload project frameworks/native/ to remote branch master:
  branch codelab ( 1 commit, Wed Aug 7 09:32:33 2019 -0700):
         ff46b36d android codelab change
to https://android-review.googlesource.com/ (y/N)? y
remote: Processing changes: refs: 1, new: 1, done
remote:
remote: SUCCESS
remote:
remote:   https://android-review.googlesource.com/c/platform/frameworks/native/+/1098432 android codelab change [NEW]
remote:
To https://android-review.googlesource.com/platform/frameworks/native
 * [new branch]          codelab -> refs/for/master

在 Gerrit 中查看您的更改

轉到終端中打印的與此類似的鏈接:

https://android-review.googlesource.com/c/platform/frameworks/native/+/1098432

這樣就完成了 Android 平台開發的入門 Codelab。有關後續步驟,請參閱提交修補程序,有關開發 Android 的完整詳細信息,請參閱本網站的其餘部分。

還原您的更改

通常,在測試後和審查和批准後,您在 Gerrit 中提交更改並將其合併到存儲庫中。

相反,出於本 Codelab 的目的,請通過單擊 Gerrit 中的Abandon來還原您的更改列表。

然後在frameworks/native項目目錄(或其子目錄)中放棄關聯的臨時分支:

repo abandon codelab .

還要記住還原您對測試文件所做的更改。由於您沒有repo startgit commitrepo upload更改,您可以重置文件本身。假設您位於aosp/platform_testing directory ,請使用以下命令重置文件:

git reset HEAD tests/example/devcodelab/src/android/test/example/devcodelab/DevCodelabTest.java
git checkout .

在這一點上,你完成了!幹得好!

得到幫助

如果您在此 Codelab 期間遇到錯誤,請使用任何頁面底部的問題跟踪器鏈接報告它們。向android-building組發送問題。