Learn to use gradle in android project You can find the samples here: https://github.com/shakalaca/learning_gradle_android

1. Gradle enabled android
project
shakalaca @ Taipei GTUG
1

2. about.me/shakalaca
shakalaca@gmail.com
http://profiles.google.com/shakalaca
2

3. Outline
• Gradle introduction
• Step by step tutorial
• Basic
• Dependency
• Sign / Proguard
• Variant
• Android Studio integration
• Q & A
3

4. Gradle
4

5. 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/
5

6. .. short version
An open source build system that combines the
power of Ant & Maven
6

7. Why gradle ?
• Powerful Build System
• Declarative, Flexible
• Imperative customization
• Tooling API
• Build System Toolkit
• Plugins create own DSL,APIs, IDE integration
• Free / Open Source
7

8. Android project
integration
• gradle android plugin
• http://tools.android.com/tech-docs/new-
build-system/
=
8

9. command
• format
• gradle <command>
• command
• tasks
• assemble
• assemble release
• assemble debug
• aR
9

10. output
• <project>/build/apk/
10

11. Basic
11

12. Eclipse project
12

13. 13

14. build.gradle
• apply plugin:‘android’
• dependencies
• compileSdkVersion
• buildToolsVersion
• defaultConfig
• sourceSets
14

15. dependencies
• compile project(‘:project1’)
• compile fileTree(dir:‘libs’, include:‘*.jar’)
• compile files(‘libs/android-support-v4.jar’)
• compile ‘com.android.support:support-
v4:13.0.0’
15

16. android packages
• com.android.support:support-v4:13.0.0
• com.android.support:support-v13:13.0.0
• com.android.support:gridlayout-v7:13.0.0
• com.google.android.gms:play-services:3.1.36
16

17. android packages
• com.android.support:support-v4:18.0.0
• com.android.support:support-v13:18.0.0
• com.android.support:gridlayout-v7:18.0.0
• com.google.android.gms:play-services:3.2.25
17

18. defaultConfig
• versionCode
• versionName
• minSdkVersion
• targetSdkVersion
• packageName
• testPackageName
• testInstrumentatio
nRunner
• signingConfig
• proguardFile
• proguardFiles
18

19. Dependency
19

20. Project structure
20

21. 21

22. settings.gradle
• Used in multi-project hierarchy
• Define projects to be used in build
22

23. settings.gradle
23

24. settings.gradle
24

25. er .. no direct way ?
25

26. 26

27. 27

28. 28

29. Sign release key
29

30. 30

31. Build Types
• default 2 types: debug & release
• for debugging & signing
31

32. Build Types
• debuggable
• jniDebugBuild
• renderscriptDebugBuild
• renderscriptOptimLevel
• packageNameSuffix
• versionNameSuffix
• signingConfig
• zipAlign
• runProguard
• proguardFile
• proguardFiles
32

33. tips
• Save your gradle.properties in ~/.gradle/
• .. If you work alone
33

34. Proguard
34

35. 35

36. Variant
36

37. Build variants
• Creating different versions of same
application
• free/paid
• multi-apk
• BuildVariant = Build Type + Product Flavor
37

38. Product Flavors
• Defines a customized version of application
build by the project
• Free / Paid
• Amazon / Play Store / blah store
• Same type as defaultConfig
38

39. 39

40. 40

41. One more thing
41

42. gradle wrapper
• Setup gradle automatically
• $ANDROID_HOME/tools/templates/gradle/
wrapper/
42

43. 43

44. summry
• simple android project
• sign release key
• run proguard
• build variants
• wrapper
44

45. Android Studio integration
45

46. Android Studio integration
BETA
46

47. Survival guide
Rule #1
Always backup your project.
47

48. Survival guide
Rule #2
Don’t import production code until 1.0 is out..
48

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)
49

50. R U KIDDING ME ?
50

51. 51

52. Basic
52

53. 53

54. configurations
54

55. 55

56. import..
56

57. import..
57

58. import..
58

59. import..
59

60. Piece of cake
60

61. Dependency
61

62. project layout
62

63. configurations
63

64. ... errrrrr
• Don’t recognize as library project
• No typo checking, no function reference,
no ...
• But you can still build the project
64

65. duplicated name ?
65

66. try another way
66

67. errrrrrr
67

68. 68

69. Refine project layout
69

70. working configurations
70

71. tips
• as simple as possible
• library/xxx_lib
• use ‘:’ instead of ‘/’ in path
• ugly, but runs fine
71

72. Local repository
72

73. 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

74. project layout
74

75. root-build.gradle
75

76. library/build.gradle
76

77. project/build.gradle
• archivesBaseName
• version
77

78. app/build.gradle
78

79. How
• deploy library
• ./gradlew deploy
• use local repository
• ./gradlew as -PuseRepo
79

80. Tricks
80

81. rename apk
81

82. launch after install
82

83. move out apk
83

84. Refresh cache
• --refresh-dependencies
• stay up-to-date (?)
http://www.gradle.org/docs/current/userguide/
dependency_management.html#sec:cache_command_line_options
84

85. Q & A
85

86. References
• http://tools.android.com/tech-docs/new-
build-system
• Guide / Samples
• http://www.gradle.org/documentation
86