关于Chromium的Android Studio使用

原文

使用

关于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 没有勾选的话勾选，然后重启。