Gradle enabled android project

Learn to use gradle in android project

Samples are here: https://github.com/shakalaca/learning_gradle_android

Transcript

1. Gradle enabled android project shakalaca @ Taipei GTUG
2. Before presentation.. • Slides •http://goo.gl/cYBZIJ • Sample codes •http://goo.gl/fxwZ9l
3. Outline • Gradle introduction • Step by step tutorial • Basic • Dependency • Sign / Proguard • Variant • Android Studio integration • Local Repository • Tricks & Tips • Q & A
4. about.me/shakalaca shakalaca@gmail.com http://profiles.google.com/shakalaca
5. • Gradle introduction • Step by step tutorial • Basic • Dependency • Sign / Proguard • Variant • Android Studio integration • Local Repository • Tricks & Tips • Q & A
6. What is gradle ? Gradle is build automation evolved. Gradle can automate the building, testing, publishing, deployment and more of software packages or other types of projects such as generated static websites, generated documentation or indeed anything else. Gradle combines the power and flexibility of Ant with the dependency management and conventions of Maven into a more effective way to build. Powered by a Groovy DSL and packed with innovation, Gradle provides a declarative way to describe all kinds of builds through sensible defaults. Gradle is quickly becoming the build system of choice for many open source projects, leading edge enterprises and legacy automation challenges. - http://www.gradle.org/
7. .. short version An open source build system that combines the power of Ant & Maven
8. Why gradle ? • Powerful Build System • Declarative, Flexible • Imperative customization • Tooling API • Build System Toolkit • Plugins create own DSL, APIs, IDE integration • Free / Open Source
9. How gradle works ? • Lifecycle • Initialization • Configuration • Execution • Build scripts • settings.gradle • build.gradle • gradle.properties
10. Command • gradle <task name> • tasks • clean • assemble • assembleRelease • assembleDebug • aR / asD
11. Android integration • gradle android plugin • http://tools.android.com/tech-docs/new- build-system/ • output • <project>/build/apk/ =
12. • Gradle introduction • Step by step tutorial • Basic • Dependency • Sign / Proguard • Variant • Android Studio integration • Local Repository • Tricks & Tips • Q & A
13. Eclipse project
15. build.gradle • apply plugin: ‘android’ • dependencies • compileSdkVersion • buildToolsVersion • defaultConfig • sourceSets
16. Dependencies • compile project(‘:project1’) • compile fileTree(dir: ‘libs’, include: ‘*.jar’) • compile files(‘libs/android-support-v4.jar’) • compile ‘com.android.support:support- v4:18.0.0’
17. Android packages • SDK Manager • Google Repository & Android Repository • Packages • com.android.support:support-v4:18.0.0 • com.android.support:appcompat-v7:18.0.0 • com.android.support:gridlayout-v7:18.0.0 • com.android.support:support-v7-mediarouter:18.0.0 • com.android.support:support-v13:18.0.0 • com.google.android.gms:play-services:3.2.25
18. defaultConfig • versionCode • versionName • minSdkVersion • targetSdkVersion • packageName • testPackageName • testInstrumentatio nRunner • signingConfig • proguardFile • proguardFiles
19. • Gradle introduction • Step by step tutorial • Basic • Dependency • Sign / Proguard • Variant • Android Studio integration • Local Repository • Tricks & Tips • Q & A
20. Project structure
22. settings.gradle • Used in multi-project hierarchy • Define projects to be used in build
23. settings.gradle
24. settings.gradle
25. er .. no direct way ?
29. • Gradle introduction • Step by step tutorial • Basic • Dependency • Sign / Proguard • Variant • Android Studio integration • Local Repository • Tricks & Tips • Q & A
31. Build types • default 2 types: debug & release • for debugging & signing
32. Build types • debuggable • jniDebugBuild • renderscriptDebugBuild • renderscriptOptimLevel • packageNameSuffix • versionNameSuffix • signingConfig • zipAlign • runProguard • proguardFile • proguardFiles
33. Tips • Save your gradle.properties in ~/.gradle/ • .. If you work alone
35. • Gradle introduction • Step by step tutorial • Basic • Dependency • Sign / Proguard • Variant • Android Studio integration • Local Repository • Tricks & Tips • Q & A
36. Build variants • Creating different versions of same application • free/paid • multi-apk • Build Variant = Build Type + Product Flavor
37. Product flavors • Defines a customized version of application build by the project • Free / Paid • Amazon / Play Store / blah store • Same type as defaultConfig
39. Build • gradle assemblePaid • gradle aPD / gradle aPR • gradle assembleFree • gradle aFD / gradle aFR
41. One more thing
42. gradle wrapper • Setup gradle automatically • $ANDROID_HOME/tools/templates/gradle/ wrapper/ • for gradle 1.7+ • execute “gradle wrapper”
44. Summary • Simple android project • Sign release key • Run proguard • Build variants • Wrapper
45. • Gradle introduction • Step by step tutorial • Basic • Dependency • Sign / Proguard • Variant • Android Studio integration • Local Repository • Tricks & Tips • Q & A
46. • Gradle introduction • Step by step tutorial • Basic • Dependency • Sign / Proguard • Variant • Android Studio integration • Local Repository • Tricks & Tips • Q & A BETA
47. Survival guide Rule #1 Always backup your project.
48. Survival guide Rule #2 Don’t import production code until 1.0 is out..
49. Best practice ? • Import modules manually • pro • short compile / AS startup time • consider project with multiple libraries.. • con • no variant builds (ok for most people)
51. Basic
53. Configurations
55. import..
56. import..
57. import..
58. import..
59. Piece of cake
60. Dependency
61. Project layout
62. Configurations
63. ... errrrrr • Don’t recognize as library project • No typo checking, no function reference, no ... • But you can still build the project
64. Duplicated name ?
65. Try another way
66. errrrrrr
68. Refine project layout
69. Working configurations
70. Tips • as simple as possible • library/xxx_lib • use ‘:’ instead of ‘/’ in path • ugly, but runs fine
71. • Gradle introduction • Step by step tutorial • Basic • Dependency • Sign / Proguard • Variant • Android Studio integration • Local Repository • Tricks & Tips • Q & A
72. What & Why ? • Use aar instead of re-compiling everything • aar: Binary distribution of an Android Library Project • http://tools.android.com/tech-docs/new- build-system/aar-format • Time is money • DRY
73. Project layout
74. root-build.gradle
75. library/build.gradle
76. project/build.gradle • archivesBaseName • version
77. app/build.gradle
78. How • deploy library • ./gradlew deploy • use local repository • ./gradlew as -PuseRepo
79. • Gradle introduction • Step by step tutorial • Basic • Dependency • Sign / Proguard • Variant • Android Studio integration • Local Repository • Tricks & Tips • Q & A
80. Rename apk
81. Launch after install
82. Move out apk
83. Refresh cache • --refresh-dependencies • stay up-to-date (?) http://www.gradle.org/docs/current/userguide/ dependency_management.html#sec:cache_command_line_options
85. Known issues • Library project is always release build • Poor NDK support • https://gist.github.com/pboos/ 5802233#file-ndk-build-gradle
86. • Gradle introduction • Step by step tutorial • Basic • Dependency • Sign / Proguard • Variant • Android Studio integration • Local Repository • Tricks & Tips • Q & A
87. References • Documentation • http://tools.android.com/tech-docs/new-build-system (Guide / Samples) • http://www.gradle.org/documentation • Forums • https://plus.google.com/u/0/communities/114791428968349268860 • https://groups.google.com/forum/#!forum/adt-dev • http://stackoverflow.com/questions/tagged/gradle • Tool • http://gradleplease.appspot.com/