Pour tous dev mobile, que ce soit seul ou en équipe, le déploiement d'une app sur le store de Google ou d'Apple est un passage (quasi) obligatoire. Android et iOS sont différents jusque dans les IDE et les outils de build. Mais au delà de XCode, Android Studio, gradle... des libraries tels que fastlane vont tenter de réconcilier (un peu) les deux univers. Nous allons voir comment intégrer la phase de publication dans le processus de build. Et cela via quelques lignes de script ou même directement dans les outils d'intégration continue tel que Jenkins

1. Déploiement automatique
d'app iOS et/ou Android
Cedric Gatay / Florian Chauveau

2. #DevFestToulouse
@Cedric_Gatay
Code-Troopers
iOS
@FlorianChauveau
Code-Troopers
Android

3. Pourquoi ?

4. #DevFestToulouse
Développeurs Java
Habitude du one-click deploy
Multiples outils

5. #DevFestToulouse
Développement mobile
IHM
Lenteur

6. #DevFestToulouse
Développement mobile
IHM
Lenteur

7. #DevFestToulouse
Objectifs

8. #DevFestToulouse
Objectifs

9. #DevFestToulouse
Objectifs
Déploiement via Jenkins
● Fiable
● Rapide
● Automatique
● Revenir dans un environnement de ‘confort’ et de facilité de livraison
=> on gagne de la confiance dans les release

10. Comment faire
traditionnellement ?

11. #DevFestToulouse
Étapes iOS
Checkout du projet
Configuration du compte dev
Récupération des certificats
Build / Archive
iTunes Connect
Screenshot / Submit
Gestion des beta testeur
Branchement Crashlytics
Commit de la nouvelle version
Création de l'app dans iTunes Connect

12. #DevFestToulouse
Étapes Android
Checkout du projet
Récupération du sdk dans la bonne version
Configuration du compte dev
Création du keystore
Configuration de la signature dans le build
Build / Archive
Google Play store
Screenshot / Submit
Gestion des beta testeur
Branchement Crashlytics
Commit de la nouvelle version
Création de l'app dans Google Play
Ajout du changelog

13. #DevFestToulouse

14. #DevFestToulouse
Oups, j'ai
changé de machine
aquaponey
baby-foot
pas le temps

15. #DevFestToulouse
Outils disponibles
https://xkcd.com/1629/

16. #DevFestToulouse
Phase 1 : Build

17. #DevFestToulouse
Android
Android Studio

18. #DevFestToulouse
Android
Android Studio

19. #DevFestToulouse
Android
Android Studio

20. #DevFestToulouse
Android
Android Studio

21. #DevFestToulouse
Android
Android Studio
Gradle
$ ./gradlew tasks

22. #DevFestToulouse
Android
Android Studio
Gradle

23. #DevFestToulouse
Android
Android Studio
Gradle
android {
signingConfigs {
release {
storeFile file("keystore.jks")
storePassword "xxxxxxxxxx"
keyAlias "release"
keyPassword "xxxxxxxxx"
}
}
buildTypes {
release {
signingConfig signingConfigs.release
}
}
}

24. #DevFestToulouse
Android
Android Studio
Gradle
Jenkins via Gradle script

25. #DevFestToulouse
iOS
XCode

26. #DevFestToulouse
iOS
XCode
CLI avec xcodebuild

27. #DevFestToulouse
iOS
XCode
CLI avec xcodebuild
Plugin Jenkins XCode

28. #DevFestToulouse
Phase 2 : Publication

29. #DevFestToulouse
Android
IHM PlayStore

30. #DevFestToulouse
Android
IHM PlayStore
API Google
● Plugin gradle
● Tache npm
● Script Python

31. #DevFestToulouse
Android
IHM PlayStore
API Google
fastlane

32. #DevFestToulouse
iOS
Connexion au compte iTunes Connect
Upload de l’IPA par Application Loader
● GUI
● CLI /Applications/Xcode.app/Contents/Applications/Application
Loader.app/Contents/Frameworks/ITunesSoftwareService.framework/Suppo
rt/altool
fastlane

33. #DevFestToulouse

34. #DevFestToulouse
fastlane
Ruby
Felix Krause @KrauseFx
Fabric puis Twitter puis Google
Regroupe un ensemble d'outils

35. #DevFestToulouse
Mise en place

36. #DevFestToulouse
Installation
$ sudo apt-get install rubygems
$ sudo gem install fastlane

37. #DevFestToulouse
iOS
$ fastlane init
$ fastlane ios test
$ fastlane ios beta
$ fastlane ios release

38. #DevFestToulouse
iOS
$ fastlane init
$ fastlane ios test
$ fastlane ios beta
$ fastlane ios release
fastlane
├── Appfile
├── Deliverfile
├── Fastfile
├── README.md
├── metadata
├── report.xml
└── screenshots

39. #DevFestToulouse
Android
$ fastlane init
$ fastlane android test
$ fastlane android beta
$ fastlane android deploy
fastlane
├── metadata
├── Appfile
├── Fastfile
├── README.md
└── report.xml

40. #DevFestToulouse
Android
Création d’un Google service account
(uniquement par le propriétaire du compte)
Téléchargement d’une clé .json
Configuration des droits sur l’app souhaitée

41. #DevFestToulouse
fastlane - iOS
Initialisation de l’app lane :produce do
produce(
username: 'user@company.com',
app_identifier: 'com.company.app',
app_name: 'App1',
language: 'Occitan',
app_version: '1.0',
sku: '123')
end

42. #DevFestToulouse
fastlane - iOS
Initialisation de l’app
Cibles pour lancer les Tests
lane :test do
scan(
scheme: "DevFestTlse"
workspace: "DevFestTlse.xcworkspace",
devices: ["iPhone X", "iPad Air"]
)
end

43. #DevFestToulouse
fastlane - iOS
Initialisation de l’app
Cibles pour lancer les Tests
Déployer en préprod
lane :alpha do
match(type: "appstore")
gym(scheme: "DevFestTlse")
pilot
increment_build_number
commit_version_bump
push_to_git_remote
end

44. #DevFestToulouse
fastlane - iOS
Initialisation de l’app
Cibles pour lancer les Tests
Déployer en préprod
Publier en production
lane :appstore do
deliver(
skip_deploy: false
)
end

45. #DevFestToulouse
fastlane - Android
Initialisation de l’app (Appfile) json_key_file "publishAccount.json"
package_name "fr.demo.devfesttoulouse2017"

46. #DevFestToulouse
fastlane - Android
Initialisation de l’app (Appfile)
Cibles pour lancer les Tests
desc "Runs all the tests"
lane :test do
gradle(task: "test")
end

47. #DevFestToulouse
fastlane - Android
Initialisation de l’app (Appfile)
Cibles pour lancer les Tests
Déployer en préprod
desc "Submit a new Beta to Crashlytics Beta"
lane :beta do
gradle(task: "assembleRelease")
crashlytics
end

48. #DevFestToulouse
fastlane - Android
Initialisation de l’app (Appfile)
Cibles pour lancer les Tests
Déployer en préprod
Publier en production
desc "Deploy a new version to the Google Play"
lane :deploy do
gradle(task: "assembleRelease")
supply
end

49. #DevFestToulouse
fastlane - Android

50. #DevFestToulouse
Utilisation au quotidien

51. #DevFestToulouse
iOS
$ fastlane match --readonly
⌘ + R dans XCode

52. #DevFestToulouse
Android
⇧+ F10

53. #DevFestToulouse
Intégration continue

54. #DevFestToulouse
En pratique
Jenkins
● Android (Docker)
● Android OpenDeviceLab
● OSX

55. #DevFestToulouse
En pratique
Jenkins
● Android (Docker)
● Android OpenDeviceLab
● OSX
def acceptSDKLicense(){
//replace with real license hash
env.LICENSE = "n8933[...]9c55"
sh 'mkdir "$ANDROID_HOME/licenses" || true'
sh 'echo -e $LICENSE >
"$ANDROID_HOME/licenses/android-sdk-license"'
sh 'echo -e $LICENSE >
"$ANDROID_HOME/licenses/android-sdk-preview-license"'
}

56. #DevFestToulouse
En pratique
Jenkins
● Android Docker
● Android OpenDeviceLab
● OSX

57. #DevFestToulouse
En pratique
Jenkins
● Android Docker
● Android OpenDeviceLab
● OSX

58. #DevFestToulouse
En pratique

59. #DevFestToulouse
Jenkinsfile
if (env.BRANCH_NAME == 'alpha'){
sh 'fastlane alpha'
}else if (env.BRANCH_NAME == 'beta'){
sh 'fastlane alphaToBeta'
}else{
sh 'fastlane build'
junit '**/test_output/*.junit'
}

60. #DevFestToulouse
Passage en alpha
● fastlane alpha
lane :alpha do
gradle(task: "assembleRelease")
supply(
track: 'alpha',
apk: '../app-release.apk'
)
end
lane :alpha do
match(type: "appstore")
gym(scheme: "Example")
pilot
increment_build_number
commit_version_bump(
message: "Bump version"
)
push_to_git_remote(
local_branch: git_branch
)
end

61. #DevFestToulouse
Passage en beta
● fastlane alphaToBeta
desc "Move from alpha to beta"
lane :alphaToBeta do
supply(
track: "alpha",
track_promote_to: "beta",
skip_upload_apk: true
)
end
desc "Move from alpha to beta"
lane :alphaToBeta do
pilot(
distribute_external: true,
changelog: "Nouvelle beta",
groups: "Beta testeurs"
)
end

62. #DevFestToulouse
Passage en Prod
● fastlane alphaToBeta
desc "Move from beta to Production"
lane :betaToProd do
supply(
track: "beta",
track_promote_to: "production",
skip_upload_apk: true
)
end
desc "Deploys to the App Store"
lane :deploy do
deliver(
force: true,
submit_for_review: true,
automatic_release: false
)
end

63. #DevFestToulouse
Configuration avancée

64. #DevFestToulouse
Android
Gestion du versionCode
lane :deploy do
increment_version_code
commit_android_version_bump
…
end

65. #DevFestToulouse
Android
Gestion du versionCode
Upload vers Crashlytics / Hockey lane :deploy do
crashlytics(
api_token: '[insert_key]',
build_secret: '[insert_secret]'
)
end

66. #DevFestToulouse
Android
Gestion du versionCode
Upload vers Crashlytics / Hockey
Versionning de la fiche du store
$ fastlane supply init

67. #DevFestToulouse
Android
Gestion du versionCode
Upload vers Crashlytics / Hockey
Versionning de la fiche du store
● Descriptions
└── fastlane
└── metadata
└── android
├── fr-FR
│ ├── full_description.txt
│ ├── short_description.txt
│ ├── title.txt
│ └── video.txt
└── en-US

68. #DevFestToulouse
Android
Gestion du versionCode
Upload vers Crashlytics / Hockey
Versionning de la fiche du store
● Descriptions
● Screenshots
└── fastlane
└── metadata
└── android
├── fr-FR
│ └── images
│ └── phoneScreenshots
│ └── sevenInchScreenshots
│ └── tenInchScreenshots
│ └── tvScreenshots
└── en-US

69. #DevFestToulouse
Android
Gestion du versionCode
Upload vers Crashlytics / Hockey
Versionning de la fiche du store
● Descriptions
● Screenshots
● What’s new
└── fastlane
└── metadata
└── android
├── fr-FR
│ └── changelogs
│ ├── 10.txt
│ └── 12.txt
└── en-US
└── changelogs
└── 12.txt

70. #DevFestToulouse
Gestion du versionCode
Upload vers Crashlytics / Hockey
Versionning de la fiche du store
● Descriptions
● Screenshots
● What’s new
Android
desc "Update store description"
lane :updateStoreDescription do
supply(
skip_upload_apk: true
)
end

71. #DevFestToulouse
iOS
Gestion du versionCode
Upload vers Crashlytics / Hockey
Versionning de la fiche du store
● Descriptions
● Screenshots
● What’s new
Génération d’une page de boarding automatique pour Testflight
http://url.c-t.io/1
http://url.c-t.io/2

72. #DevFestToulouse
fastlane
MEH...

73. #DevFestToulouse
Utilisation d'un dépôt git chiffré
Manipule les certificats sur developer.apple.com
Permet d’éviter le “revoke”
fastlane

74. #DevFestToulouse
Gestion des certificats centralisée
Plus besoin de donner accès à tous
Seule la CI peut avoir un accès R/W
fastlane

75. #DevFestToulouse
Lance les tests sur x devices dans y locale
Piloté depuis les tests UI
$ fastlane snapshot init
fastlane
let app = XCUIApplication()
setupSnapshot(app)
app.launch()
snapshot("01HomeScreen")

76. #DevFestToulouse
Génère des visuels
● device frame
● marketing
fastlane
lane :screenshots do
snapshot
frameit(white: true, path:
'./fastlane/screenshots')
end

77. #DevFestToulouse
fastlane
Intégration avec Slack
Auto-bump version et commit
Installation automatique des cocoapods
Gestion des certificats de push (APNS)
Shell scripts / Plugins

78. #DevFestToulouse
Exemple
Beaucoup d’exemples dans le repo fastlane/examples
● Fabric
● Firefox
● Soundcloud
● Wikipedia
● ProductHunt

79. #DevFestToulouse
Conclusion

80. #DevFestToulouse
En pratique
Toolchain de deploy identique
● tout le monde peut livrer en 1 clic
● rapports de tests classiques
● Jenkins Multibranch Pipeline

81. #DevFestToulouse
En pratique
Toolchain de deploy identique
● tout le monde peut livrer en 1 clic
● rapports de tests classiques
● Jenkins Multibranch Pipeline

82. #DevFestToulouse
Points de vigilance
fastlane est très (trop) régulièrement mis à jour
Reverse engineering de l’API iTunes connect
Un contributeur principal (SPOF)

83. #DevFestToulouse
Merci !
https://url.c-t.io/1
https://url.c-t.io/2