Chromium Code Reviews
chromiumcodereview-hr@appspot.gserviceaccount.com (chromiumcodereview-hr) | Please choose your nickname with Settings | Help | Chromium Project | Gerrit Changes | Sign out
(115)

Side by Side Diff: docs/android_studio.md

Issue 2687453002: Reland "Android: Add owned resources to android studio" (Closed)
Patch Set: Fix per review Created 3 years, 10 months ago
Use n/p to move between diff chunks; N/P to move between comments. Draft comments are only viewable by you.
Jump to:
View unified diff | Download patch
« no previous file with comments | « build/android/gradle/generate_gradle.py ('k') | no next file » | no next file with comments »
Toggle Intra-line Diffs ('i') | Expand Comments ('e') | Collapse Comments ('c') | Show Comments Hide Comments ('s')
OLDNEW
1 # Android Studio 1 # Android Studio
2 2
3 [TOC] 3 [TOC]
4 4
5 ## Usage 5 ## Usage
6 6
7 Make sure you have followed 7 Make sure you have followed
8 [android build instructions](android_build_instructions.md) already. 8 [android build instructions](android_build_instructions.md) already.
9 9
10 ```shell 10 ```shell
11 build/android/gradle/generate_gradle.py 11 build/android/gradle/generate_gradle.py
12 ``` 12 ```
13 13
14 This creates a project at `out/Debug/gradle`. To create elsewhere: 14 This creates a project at `out/Debug/gradle`. To create elsewhere:
15 15
16 ```shell 16 ```shell
17 build/android/gradle/generate_gradle.py --output-directory out/My-Out-Dir --proj ect-dir my-project 17 build/android/gradle/generate_gradle.py --output-directory out/My-Out-Dir --proj ect-dir my-project
18 ``` 18 ```
19 19
20 By default, only common targets are generated. To customize the list of targets 20 By default, only common targets are generated. To customize the list of targets
21 to generate projects for: 21 to generate projects for:
22 22
23 ```shell 23 ```shell
24 build/android/gradle/generate_gradle.py --target //some:target_apk --target //so me/other:target_apk 24 build/android/gradle/generate_gradle.py --target //chrome/android:chrome_public_ apk --target //android_webview/test:android_webview_apk
25 ``` 25 ```
26 26
27 For first-time Android Studio users: 27 For first-time Android Studio users:
28 28
29 * Avoid running the setup wizard. 29 * Avoid running the setup wizard.
30 * The wizard will force you to download unwanted SDK components to 30 * The wizard will force you to download unwanted SDK components to
31 `//third_party/android_tools`. 31 `//third_party/android_tools`.
32 * To skip it, select "Cancel" when it comes up. 32 * To skip it, select "Cancel" when it comes up.
33 33
34 To import the project: 34 To import the project:
35 35
36 * Use "Import Project", and select the directory containing the generated 36 * Use "Import Project", and select the directory containing the generated
37 project, by default `out-gn/Debug/gradle`. 37 project, by default `out/Debug/gradle`.
38 38
39 You need to re-run `generate_gradle.py` whenever `BUILD.gn` files change. 39 You need to re-run `generate_gradle.py` whenever `BUILD.gn` files change.
40 40
41 * After regenerating, Android Studio should prompt you to "Sync". If it 41 * After regenerating, Android Studio should prompt you to "Sync". If it
42 doesn't, use: 42 doesn't, use:
43 * Button with two arrows on the right side of the top strip.
43 * Help -> Find Action -> "Sync Project with Gradle Files" 44 * Help -> Find Action -> "Sync Project with Gradle Files"
44 45 * After `gn clean` you may need to restart Android Studio.
45 46
46 ## How it Works 47 ## How it Works
47 48
48 Android Studio integration works by generating `build.gradle` files based on GN 49 Android Studio integration works by generating `build.gradle` files based on GN
49 targets. Each `android_apk` and `android_library` target produces a separate 50 targets. Each `android_apk` and `android_library` target produces a separate
50 Gradle sub-project. 51 Gradle sub-project.
51 52
52 ### Excluded files and .srcjars 53 ### Excluded files and .srcjars
53 54
54 Gradle supports source directories but not source files. However, some 55 Gradle supports source directories but not source files. However, some
(...skipping 53 matching lines...) Expand 10 before | Expand all | Expand 10 after
108 109
109 The resulting artifacts are not terribly useful. They are missing assets, 110 The resulting artifacts are not terribly useful. They are missing assets,
110 resources, native libraries, etc. 111 resources, native libraries, etc.
111 112
112 * Use a 113 * Use a
113 [gradle daemon](https://docs.gradle.org/2.14.1/userguide/gradle_daemon.html) 114 [gradle daemon](https://docs.gradle.org/2.14.1/userguide/gradle_daemon.html)
114 to speed up builds using the gradlew script: 115 to speed up builds using the gradlew script:
115 * Add the line `org.gradle.daemon=true` to `~/.gradle/gradle.properties`, 116 * Add the line `org.gradle.daemon=true` to `~/.gradle/gradle.properties`,
116 creating it if necessary. 117 creating it if necessary.
117 118
118 ## Status (as of Jan 19, 2017) 119 ## Status (as of Feb 7th, 2017)
119 120
120 ### What works 121 ### What works
121 122
122 * Tested with Android Studio v2.2. 123 * Tested with Android Studio v2.2.
123 * Java editing and gradle compile works. 124 * Java editing and gradle compile works.
124 * Instrumentation tests included as androidTest. 125 * Instrumentation tests included as androidTest.
125 * Symlinks to existing .so files in jniLibs (doesn't generate them). 126 * Symlinks to existing .so files in jniLibs (doesn't generate them).
127 * Editing resource xml files.
126 128
127 ### What doesn't work (yet) ([crbug](https://bugs.chromium.org/p/chromium/issues /detail?id=620034)) 129 ### What doesn't work (yet) ([crbug](https://bugs.chromium.org/p/chromium/issues /detail?id=620034))
128 130
129 * Make gradle aware of resources and assets 131 * Make gradle aware of assets
132 * Layout editor
130 * Add a mode in which gradle is responsible for generating `R.java` 133 * Add a mode in which gradle is responsible for generating `R.java`
131 * Add support for native code editing 134 * Add support for native code editing
132 * Make the "Make Project" button work correctly 135 * Make the "Make Project" button work correctly
OLDNEW
« no previous file with comments | « build/android/gradle/generate_gradle.py ('k') | no next file » | no next file with comments »

Powered by Google App Engine
This is Rietveld 408576698