Gradle enabled android project

Slide 1

Slide 1 text

Gradle enabled android project shakalaca @ Taipei GTUG

Slide 2

Slide 2 text

Before presentation.. • Slides •http://goo.gl/cYBZIJ • Sample codes •http://goo.gl/fxwZ9l

Slide 3

Slide 3 text

Outline • Gradle introduction • Step by step tutorial • Basic • Dependency • Sign / Proguard • Variant • Android Studio integration • Local Repository • Tricks & Tips • Q & A

Slide 4

Slide 4 text

about.me/shakalaca [email protected] http://proﬁles.google.com/shakalaca

Slide 5

Slide 5 text

• Gradle introduction • Step by step tutorial • Basic • Dependency • Sign / Proguard • Variant • Android Studio integration • Local Repository • Tricks & Tips • Q & A

Slide 6

Slide 6 text

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 ﬂexibility 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/

Slide 7

Slide 7 text

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

Slide 8

Slide 8 text

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

Slide 9

Slide 9 text

How gradle works ? • Lifecycle • Initialization • Conﬁguration • Execution • Build scripts • settings.gradle • build.gradle • gradle.properties

Slide 10

Slide 10 text

Command • gradle • tasks • clean • assemble • assembleRelease • assembleDebug • aR / asD

Slide 11

Slide 11 text

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

Slide 12

Slide 12 text

• Gradle introduction • Step by step tutorial • Basic • Dependency • Sign / Proguard • Variant • Android Studio integration • Local Repository • Tricks & Tips • Q & A

Slide 13

Slide 13 text

Eclipse project

Slide 14

Slide 14 text

No content

Slide 15

Slide 15 text

build.gradle • apply plugin: ‘android’ • dependencies • compileSdkVersion • buildToolsVersion • defaultConﬁg • sourceSets

Slide 16

Slide 16 text

Dependencies • compile project(‘:project1’) • compile ﬁleTree(dir: ‘libs’, include: ‘*.jar’) • compile ﬁles(‘libs/android-support-v4.jar’) • compile ‘com.android.support:support- v4:18.0.0’

Slide 17

Slide 17 text

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

Slide 18

Slide 18 text

defaultConﬁg • versionCode • versionName • minSdkVersion • targetSdkVersion • packageName • testPackageName • testInstrumentatio nRunner • signingConﬁg • proguardFile • proguardFiles

Slide 19

Slide 19 text

• Gradle introduction • Step by step tutorial • Basic • Dependency • Sign / Proguard • Variant • Android Studio integration • Local Repository • Tricks & Tips • Q & A

Slide 20

Slide 20 text

Project structure

Slide 21

Slide 21 text

No content

Slide 22

Slide 22 text

settings.gradle • Used in multi-project hierarchy • Deﬁne projects to be used in build

Slide 23

Slide 23 text

settings.gradle

Slide 24

Slide 24 text

settings.gradle

Slide 25

Slide 25 text

er .. no direct way ?

Slide 26

Slide 26 text

No content

Slide 27

Slide 27 text

No content

Slide 28

Slide 28 text

No content

Slide 29

Slide 29 text

• Gradle introduction • Step by step tutorial • Basic • Dependency • Sign / Proguard • Variant • Android Studio integration • Local Repository • Tricks & Tips • Q & A

Slide 30

Slide 30 text

No content

Slide 31

Slide 31 text

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

Slide 32

Slide 32 text

Build types • debuggable • jniDebugBuild • renderscriptDebugBuild • renderscriptOptimLevel • packageNameSuffix • versionNameSuffix • signingConfig • zipAlign • runProguard • proguardFile • proguardFiles

Slide 33

Slide 33 text

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

Slide 34

Slide 34 text

No content

Slide 35

Slide 35 text

• Gradle introduction • Step by step tutorial • Basic • Dependency • Sign / Proguard • Variant • Android Studio integration • Local Repository • Tricks & Tips • Q & A

Slide 36

Slide 36 text

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

Slide 37

Slide 37 text

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

Slide 38

Slide 38 text

No content

Slide 39

Slide 39 text

Build • gradle assemblePaid • gradle aPD / gradle aPR • gradle assembleFree • gradle aFD / gradle aFR

Slide 40

Slide 40 text

No content

Slide 41

Slide 41 text

One more thing

Slide 42

Slide 42 text

gradle wrapper • Setup gradle automatically • $ANDROID_HOME/tools/templates/gradle/ wrapper/ • for gradle 1.7+ • execute “gradle wrapper”

Slide 43

Slide 43 text

No content

Slide 44

Slide 44 text

Summary • Simple android project • Sign release key • Run proguard • Build variants • Wrapper

Slide 45

Slide 45 text

• Gradle introduction • Step by step tutorial • Basic • Dependency • Sign / Proguard • Variant • Android Studio integration • Local Repository • Tricks & Tips • Q & A

Slide 46

Slide 46 text

• Gradle introduction • Step by step tutorial • Basic • Dependency • Sign / Proguard • Variant • Android Studio integration • Local Repository • Tricks & Tips • Q & A BETA

Slide 47

Slide 47 text

Survival guide Rule #1 Always backup your project.

Slide 48

Slide 48 text

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

Slide 49

Slide 49 text

Best practice ? • Import modules manually • pro • short compile / AS startup time • consider project with multiple libraries.. • con • no variant builds (ok for most people)

Slide 50

Slide 50 text

No content

Slide 51

Slide 51 text

Basic

Slide 52

Slide 52 text

No content

Slide 53

Slide 53 text

Conﬁgurations

Slide 54

Slide 54 text

No content

Slide 55

Slide 55 text

import..

Slide 56

Slide 56 text

import..

Slide 57

Slide 57 text

import..

Slide 58

Slide 58 text

import..

Slide 59

Slide 59 text

Piece of cake

Slide 60

Slide 60 text

Dependency

Slide 61

Slide 61 text

Project layout

Slide 62

Slide 62 text

Conﬁgurations

Slide 63

Slide 63 text

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

Slide 64

Slide 64 text

Duplicated name ?

Slide 65

Slide 65 text

Try another way

Slide 66

Slide 66 text

errrrrrr

Slide 67

Slide 67 text

No content

Slide 68

Slide 68 text

Reﬁne project layout

Slide 69

Slide 69 text

Working conﬁgurations

Slide 70

Slide 70 text

Tips • as simple as possible • library/xxx_lib • use ‘:’ instead of ‘/’ in path • ugly, but runs ﬁne

Slide 71

Slide 71 text

• Gradle introduction • Step by step tutorial • Basic • Dependency • Sign / Proguard • Variant • Android Studio integration • Local Repository • Tricks & Tips • Q & A

Slide 72

Slide 72 text

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

Slide 73

Slide 73 text

Project layout

Slide 74

Slide 74 text

root-build.gradle

Slide 75

Slide 75 text

library/build.gradle

Slide 76

Slide 76 text

project/build.gradle • archivesBaseName • version

Slide 77

Slide 77 text

app/build.gradle

Slide 78

Slide 78 text

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

Slide 79

Slide 79 text

• Gradle introduction • Step by step tutorial • Basic • Dependency • Sign / Proguard • Variant • Android Studio integration • Local Repository • Tricks & Tips • Q & A

Slide 80

Slide 80 text

Rename apk

Slide 81

Slide 81 text

Launch after install

Slide 82

Slide 82 text

Move out apk

Slide 83

Slide 83 text

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

Slide 84

Slide 84 text

No content

Slide 85

Slide 85 text

Known issues • Library project is always release build • Poor NDK support • https://gist.github.com/pboos/ 5802233#ﬁle-ndk-build-gradle

Slide 86

Slide 86 text

• Gradle introduction • Step by step tutorial • Basic • Dependency • Sign / Proguard • Variant • Android Studio integration • Local Repository • Tricks & Tips • Q & A

Slide 87

Slide 87 text

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://stackoverﬂow.com/questions/tagged/gradle • Tool • http://gradleplease.appspot.com/