原文

使用

關于generate_gradle.py，在構建調試chromium for android一文中提到過，主要是用來產生android studio能夠識別的項目。

build/android/gradle/generate_gradle.py

參數canary產生基于Android Studio3.1的工程

build/android/gradle/generate_gradle.py [--canary]  # Use --canary for Android Studio 3.1 canary

一般而言是在out/Debug/gradle產生工程，如果想要在別的地方

build/android/gradle/generate_gradle.py --output-directory out/My-Out-Dir --project-dir my-project

—output-directory是當時ninja輸出的目錄，而且—project-dir是android studio后來打開的目錄

如果想要添加額外的target的話

build/android/gradle/generate_gradle.py --extra-target //chrome/android:chrome_public_apk

對于首次使用Android Studio的用戶

• 避免運行Setup wizard

  • 它會迫使你在//third_party/android_tools下不想要的sdk組件
  • 跳過它，當它出現的時候就選擇“取消”

對于從Android Studio 2.2升級到2.3的：

• 使用gn clean以及gn gen
• 使用git clean -ffd清理//third_party/android_tools
• 將項目從android studio中移除，然后用generate_gradle.py重新

為了導入工程:

• 使用“import Project"，然后選擇包含通用項目的目錄，默認是out/Debug/gradle
  每當BUILD.gn變更的時候，都需要從新運行generate_gradle.py
• 在重新生成以后，Android Studio應該提醒你Sync，如果并沒有，那么
  • 在頂部有兩個箭頭的按鈕
  • Help->Find Action->Sync Project with Gradle Files
  • 在gn clean以后，你需要重啟Android Studio

怎么工作

一般情況下，只產生一個模塊，如果多于一個apk產生的話，那么_all模塊會產生。 instrumentation tests和apk_under_test對象是綁定的，它們是作為一個模塊的。

如果想了解gn對象的更多細節結構，使用—split-projects的flag，它會在依賴圖中為每個gn對象都產生一個模塊。

Excluded Files

gradle支持source directories，但是不支持source files，然而，chromium的文件被多個target使用，為了適應這個現象，腳本檢測這些target，創造了exclude pattern來把不在這個target的文件給去掉。

提取 .srcjars

在GN中大部分產生的.java文件以.srcjars形式存儲。Android Studio并不支持他們，所以generator script構建以及提取它們到extracted-srcjars 子目錄，這也是為什么_all包含多種generated files的備份的緣故。

Android Studio的tip

• 配置指令能夠在這里找到，一個建議：

  • 使用更多的RAM ：STUDIO_VM_OPTIONS=-Xmx2048m /opt/android-studio-stable/bin/studio-launcher.sh

• 如果你從來不需要reset，rm -r ~/.AndroidStudio*/(這里不懂)

• 導入Android風格的設置：

  • Help -> Find Action -> “Code Style” (settings) -> Java -> Manage -> Import -> select “Intellij IDEA code style XML” -> OK
  • 選擇tools/android/android_studio/ChromiumStyle.xml

• 鼠標移動的時候轉到文檔

  • Help -> Find Action -> “Show quick documentation on mouse move”

• 開啟行數

  • Help -> Find Action -> “Show line numbers”

• 變更文件的樣式

  • 設置版本控制
    • File -> Settings -> Version Control
    • 添加src directories
  • 提交改變以及以及更新重新設定樣式
    • Help -> Find Action -> “Commit Changes”
    • 檢查 “Reformat code” & “Optimize imports” 然后提交

有用的快捷方式

• Shift - Shift：雙擊Shift打開文件以及執行IDE的action
• Ctrl + N：跳到class
• Ctrl + Shift + T：跳到Test
• Ctrl + Shift + N：跳到文件
• Ctrl + F12：跳到方法
• Ctrl + G：跳到行數
• Shift + F6：重命名變量
• Ctrl + Alt + O：組織imports
• Alt + Enter：快速Fix
• F2：找到下一個Error

從命令行構建

在Android Studio導入項目以后，Gradle在能夠從命令行構建。

cd $GRADLE_PROJECT_DIR && bash gradlew

結果丟失assets, resources, 本地的庫等

• 使用gradle daemon來加速構建gradlew腳本:
  • 在~/.gradle/gradle.properties添加行org.gradle.daemon=true，如果沒有這個文件就創建它

一個常見的問題，在構建完了項目以后，并不能找到相應的文件，例如tab.java，這個時候可以看一下plugin的問題，菜單->Preferences->Plugins->Android Support 沒有勾選的話勾選，然后重啟。