Как минимизировать рутину, чтобы не спиться

Сергей Боиштян, Tinkoff – MOSDROID #8 Oxygen

Эта история для тех, кто чует, что рано или поздно он будет лидом, либо менеджером проекта, либо он просто никак не может написать свой первый gradle plugin.

Я расскажу как я столкнулся с передвижением задач на доске, проставлением “rc” в задачах руками, сборкой для тестировщиков и публикацией в play market, приуныл и выходил из этого состояния с помощью gradle, git и щепотки teamcity

Transcript

1. Как минимизировать рутину, чтобы не спиться Сергей Боиштян, Tinkoff.ru
2. Обо мне Android разработчик/архитектор/лид 2
3. Android dev podcast 3
4. Начало Я стал “Лидом”/”Архитектором” Появилось много ответственностей связанных с процессом Например сделать apk для тестирования 4
5. Сделать сборку тестировщику 1. Саму сборку сделать просто a. Сделать apk b. Залить в hockeyapp, Beta 5 2. Не просто понять, что тестировать на сборке
6. Почему не просто понять • Задача и сборка не связаны • Может быть несколько сборок параллельно 6
7. Решение • Собрать apk ◦ versionName, versionCode, archiveName связать с версией • Отправить в hockeyApp, beta • Перевести задачи в нужный статус • Проставить внутри задач версию для связи со сборкой 7
8. Проблемы Нет явного триггера для действия Много шагов Легко забыть что-нибудь Можно заболеть 8
9. Проблемы Нет явного триггера для действия Много шагов Легко забыть что-нибудь Можно заболеть 9
10. Когда “накипело” Начал искать решения Оказалось, что их много И было то, которое я взял за основу 10
11. Решение, взятое за основу • Есть ветка в git ◦ В нее попадают изменения ◦ Триггерится сборка на CI ◦ Она собирает apk ▪ versionName берется из локального файла ▪ versionCode - teamcity buildNumber ◦ Apk попадает в hockeyApp ◦ Задачи меняют статус ◦ versionName, versionCode проставляются в задаче 11
12. Недостатки решения • Нет явного триггера • Для инкремента версии, нужно сделать commit • versionCode не явно связан с историей git 12
13. Что я улучшил Автоматизировал инкремент версии Что позволило автоматизировать триггер, для формирования сборки 13
14. Инкремент версии: формат Формат - Semantic Versioning Specification 1.0.0-rc1 14
15. Инкремент версии: хранение git tag -a 1.0.0-rc1 -m ‘message’ • Не ломает историю • Легче добавить/удалить на remote • Своя система прав 15
16. Логика инкремента версии После триггера • я получаю список задач, готовых для тестирования • беру из них версию • нахожу в git максимальный tag • сравниваю и инкрементирую, если нужно 16
17. Логика инкремента версии Решение https://github.com/gladed/gradle-android-git-version Реализовано чтение tag Не реализован инкремент 17
18. Вызовы Реализовать инкремент Дописать логику для ‘rc’ Объединить все части 18
19. Возможные реализации Bash fastline (ruby) Gradle etc. 19
20. Gradle Нативная система сборки Плагинная система Возможность писать на Java, Kotlin, Scala :? Но кого я обманываю Groovy 20
21. Знакомство Plugin writer 21
22. Знакомство Plugin writer Build script writer 22
23. Знакомство Plugin writer Build script writer App developer 23
24. Gradle решения Build script Binary plugin 24
25. Build script task myTask { println 'Hello world' } 25
26. Все ли возможно на build script? Подключение готовых библиотек Подключение готовых плагинов Распространение кода 26
27. Build script buildscript { dependencies { classpath 'our:dependency:1.0' } } 27
28. Build script import our.dependency.Task task myTask { Task().execute() } 28
29. Не все так гладко. “apply from:” вынес в myTask.gradle import our.dependency.Task task myTask { Task().execute() } 29
30. Не все так гладко. “apply from:” В build.gradle apply from: 'myTask.gradle' FAILURE: Build failed with an exception. unable to resolve class our.dependency.Task 30
31. Не все так гладко. “apply from:” https://github.com/gradle/gradle/issues/1262 Central plugin classpath management 31
32. 32 //build.gradle buildscript { repositories { ... } dependencies { classpath "org._10ne.gradle:rest-gradle-plugin:0.4.2" //any external plugin can be used } } apply plugin: "org.tenne.rest" task fromMain(type: org._10ne.gradle.rest.RestTask) { //works fine //... } apply from: 'gradle/other.gradle'
33. 33 //other.gradle task fromOther(type: org._10ne.gradle.rest.RestTask) { //fails //... } FAILURE: Build failed with an exception. * Where: Script '/tmp/plugin-class-other-script/gradle/other.gradle' line: 1 * What went wrong: A problem occurred evaluating script. > Could not get unknown property 'org' for root project 'plugin-class-other-script' of type org.gradle.api.Project.
34. Итоги Build script Вам этого достаточно, если: Вы не хотите шарить между (android) проектами Вы не хотите писать на других JVM языках Вы не адекватный Вы в самом начале 34
35. Plugin Легко шарить Легче поддерживать Легче тестировать 35
36. Структура плагина Это gradle проект • build.gradle • Plugin class • Descriptor • One or more tasks • Extension 36
37. Структура плагина Plugin Extention Task Descriptor build.gradle 37
38. Plugin build.gradle apply plugin: 'groovy' apply plugin: 'idea' repositories { mavenCentral() } dependencies { compile localGroovy() compile gradleApi() compile 'commons-io:commons-io:2.4' testCompile 'junit:junit:4.12' } 38
39. Plugin class Создание task Создание extension Связь с build chain 39
40. Plugin class class HockeyAppPlugin implements Plugin<Project> { void apply(Project project) { project.extensions.create('hockeyapp', HockeyAppPluginExtension, project) if (project.plugins.hasPlugin(AppPlugin)) { AppExtension android = project.android android.applicationVariants.all { variant -> def taskName = "upload${variant.name.capitalize()}ToHockeyApp" def uploadTask = project.tasks.create(taskName, HockeyAppUploadTask) uploadTask.group = 'HockeyApp' uploadTask.dependsOn variant.assemble } } } 40
41. Plugin class - create task class HockeyAppPlugin implements Plugin<Project> { void apply(Project project) { project.extensions.create('hockeyapp', HockeyAppPluginExtension, project) if (project.plugins.hasPlugin(AppPlugin)) { AppExtension android = project.android android.applicationVariants.all { variant -> def taskName = "upload${variant.name.capitalize()}ToHockeyApp" def uploadTask = project.tasks.create(taskName, HockeyAppUploadTask) uploadTask.group = 'HockeyApp' uploadTask.dependsOn variant.assemble } } } 41
42. Plugin class - extention class HockeyAppPlugin implements Plugin<Project> { void apply(Project project) { project.extensions.create('hockeyapp', HockeyAppPluginExtension) //... } } } 42
43. Plugin class - связь с build chain class HockeyAppPlugin implements Plugin<Project> { void apply(Project project) { project.extensions.create('hockeyapp', HockeyAppPluginExtension, project) if (project.plugins.hasPlugin(AppPlugin)) { AppExtension android = project.android android.applicationVariants.all { variant -> def taskName = "upload${variant.name.capitalize()}ToHockeyApp" def uploadTask = project.tasks.create(taskName, HockeyAppUploadTask) uploadTask.group = 'HockeyApp' uploadTask.dependsOn variant.assemble } } } 43
44. Task class HockeyAppUploadTask extends DefaultTask { @TaskAction def upload() throws IOException { //... } 44
45. Task - group name class HockeyAppPlugin implements Plugin<Project> { void apply(Project project) { project.extensions.create('hockeyapp', HockeyAppPluginExtension, project) if (project.plugins.hasPlugin(AppPlugin)) { AppExtension android = project.android android.applicationVariants.all { variant -> def taskName = "upload${variant.name.capitalize()}ToHockeyApp" def uploadTask = project.tasks.create(taskName, HockeyAppUploadTask) uploadTask.group = 'HockeyApp' } } } } 45
46. Find extention HockeyAppPluginExtension hockeyApp = project.hockeyapp 46
47. Extension for users hockeyapp { notify = 1 status = 2 notesType = 0 releaseType = 0 teamCityLog = true repositoryUrl = '' variantToApplicationId = [] } 47
48. Extention class class HockeyAppPluginExtension { def Object outputDirectory def File symbolsDirectory = null def String apiToken = null def Map<String, String> variantToApiToken = null def Map<String, String> variantToNotes = null def String status = 2 def String strategy = "add" def String notify = 0 def Map<String, String> variantToNotify = null //... } 48
49. Descriptor implementation-class=de.felixschulze.gradle.HockeyAppPlugin apply plugin: ‘descriptor file name’ 49
50. Подключение к своему проекту In build.gradle apply plugin: ‘descriptor file name' hockeyapp { //... } 50
51. Зависимость между task хочу после обновления Версии грузить в hockeyApp apk 51
52. Зависимость между task Есть два плагина: class Hello implements Plugin<Project>{ @Override void apply(Project project) { project.tasks.create('hello') { doLast { println "Hello, it's me" } } } } class IWasWondering implements Plugin<Project> { @Override void apply(Project project) { project.tasks.create('iWasWondering') { doLast { println "I was wondering if after all these years\n" + " You 'd like to meet" } } } } 52
53. Зависимость между task Подключаем к проекту in build.gradle apply plugin: IWasWondering apply plugin: Hello 53
54. Варианты связывания dependsOn finalizedBy mustRunAfter(shouldRunAfter) 54
55. Зависимость между task - DependsOn class Hello implements Plugin<Project>{ @Override void apply(Project project) { project.tasks.create('hello') { doLast { println "Hello, it's me" } } } } class IWasWondering implements Plugin<Project> { @Override void apply(Project project) { project.tasks.create('iWasWondering') { dependsOn(project.hello) doLast { println "I was wondering if after all these years\n" + " You 'd like to meet" } } } } 55
56. DependsOn результат №1 ./gradlew iWasWondering Заработает? A problem occurred evaluating project ':ui'. > Failed to apply plugin [class 'IWasWondering'] > Could not get unknown property 'hello' for task ':ui:iWasWondering' of type org.gradle.api.DefaultTask. 56
57. DependsOn поиск проблемы Может дело в порядке apply: Было in build.gradle apply plugin: IWasWondering apply plugin: Hello Стало in build.gradle apply plugin: Hello apply plugin: IWasWondering 57
58. Executing tasks: [:ui:iWasWondering] :ui:hello Hello it's me :ui:iWasWondering I was wondering if after all these years You'd like to meet BUILD SUCCESSFUL in 0s 58
59. Gradle build lifecycle Initialization Configuration Execution 59
60. Configuration Execute build.gradle beforeEvaluate afterEvaluate 60
61. Execute build.gradle apply plugin: Hello class Hello implements Plugin<Project>{ @Override void apply(Project project) { project.tasks.create('hello') { doLast { println "Hello, it's me" } } } } 61
62. Случайная последовательность apply class IWasWondering implements Plugin<Project> { @Override void apply(Project project) { project.tasks.create('iWasWondering') { doLast { println "I was wondering if after all these years\n" + " You 'd like to meet" } } project.with { afterEvaluate { iWasWondering.dependsOn(hello) } } } } 62
63. FinalizedBy class Hello implements Plugin<Project> { @Override void apply(Project project) { project.tasks.create('hello') { finalizedBy('iWasWondering') doLast { println "Hello, it's me" } } } } 63
64. Executing tasks: [:ui:hello] :ui:hello Hello it's me :ui:iWasWondering I was wondering if after all these years You'd like to meet BUILD SUCCESSFUL in 0s 64
65. MustRunAfter “When you use the “must run after” ordering rule you specify that taskB must always run after taskA, whenever both taskA and taskB will be run. This is expressed as taskB.mustRunAfter(taskA). “ 65
66. MustRunAfter class IWasWondering implements Plugin<Project> { @Override void apply(Project project) { project.tasks.create('iWasWondering') { doLast { println "I was wondering if after all these years\n" + " You 'd like to meet" } mustRunAfter(project.hello) } } } 66
67. ./gradlew hello A) Hello it’s me C) Hello it’s me I was wondering if after all these years You’d like to meet B) I was wondering if after all these years You’d like to meet Hello it’s me D) Невозможно спрогнозировать 67
68. ./gradlew hello A) Hello it’s me C) Hello it’s me I was wondering if after all these years You’d like to meet B) I was wondering if after all these years You’d like to meet Hello it’s me D) Невозможно спрогнозировать 68
69. Executing tasks: [hello, iWasWondering] :ui:hello Hello, it's me :ui:iWasWondering I was wondering if after all these years You 'd like to meet BUILD SUCCESSFUL in 0s 69
70. Вернемся к dependsOn class Hello implements Plugin<Project>{ @Override void apply(Project project) { project.tasks.create('hello') { doLast { println "Hello, it's me" } } } } class IWasWondering implements Plugin<Project> { @Override void apply(Project project) { project.tasks.create('iWasWondering') { dependsOn(project.hello) doLast { println "I was wondering if after all these years\n" + " You 'd like to meet" } } } } 70
71. ./gradlew iWasWondering hello A) Hello it’s me Hello it’s me I was wondering if after all these years You’d like to meet C) Hello it’s me I was wondering if after all these years You’d like to meet Hello it’s me B) Hello it’s me I was wondering if after all these years You’d like to meet D) Невозможно спрогнозировать 71
72. ./gradlew iWasWondering hello A) Hello it’s me Hello it’s me I was wondering if after all these years You’d like to meet C) Hello it’s me I was wondering if after all these years You’d like to meet Hello it’s me B) Hello it’s me I was wondering if after all these years You’d like to meet D) Невозможно спрогнозировать 72
73. В какой фазе выполняется? android { defaultConfig { versionCode androidVersionCode() versionName androidVersionName() } } def androidVersionName() {} def androidVersionCode() {} 73
74. В какой фазе выполняется? A) Initialization B) Execution B) Configuration D) Моя твоя не понимай 74
75. В какой фазе выполняется? A) Initialization B) Execution B) Configuration D) Моя твоя не понимай 75
76. Тестирование class AndroidGitVersionTest extends GroovyTestCase { @Lazy TemporaryFolder projectFolder = { TemporaryFolder folder = new TemporaryFolder() folder.create() folder.newFile("build.gradle") return folder }() @Lazy Project project = { ProjectBuilder.builder() .withProjectDir(projectFolder.root) .build() }() 76
77. Тестирование @Lazy TemporaryFolder projectFolder @Lazy Project project @Lazy AndroidGitVersionExtension plugin = { project.pluginManager.apply 'com.gladed.androidgitversion' def extension = project.getExtensions().getByName('androidGitVersion') assertTrue(extension instanceof AndroidGitVersionExtension) return (AndroidGitVersionExtension) extension }() void testNoGitRepo() { assertEquals('unknown', plugin.name()) assertEquals(0, plugin.code()) } 77
78. Не успел UP-TO-DATE Skip tasks Debug scripts 78
79. Итоги 79