Scripts de build e servidores de CI: você nunca mais vai querer executar qualquer tarefa de forma manual

Scripts de build e
servidores de CI
Você nunca mais vai querer executar
qualquer tarefa de forma manual
Ione Souza Junior

View Slide

Apresentação
Ione Souza Junior
Desenvolvedor mobile @
Unimestre
❤ Xamarin

View Slide

O que veremos na apresentação?

View Slide

O que veremos na apresentação?
→ Um estudo de caso sobre como foi realizado a
entrega de um app para diversos clientes
→ Discutir as diﬁculdades encontradas
→ Mostrar as soluções adotadas

View Slide

História do app

View Slide

História do app
→ Era uma vez um ERP...
→ Um app foi desenvolvido integrado ao sistema
→ App foi publicado, os clientes começaram a usar
o app, até que...

View Slide

História do app
→ Alguns clientes se demonstraram um pouco
vaidosos
→ Eles queriam um app próprio, publicado com seu
nome e sua logo

View Slide

E agora, o que fazer?

View Slide

Que tal fazer um fork
do projeto original?

View Slide

Fork
→ O fork foi o começo do ﬁm...
→ Muitos conﬂitos
→ A demanda aumentou: mais projetos, mais
trabalho, menos tempo para tomar café

View Slide

E se adotasse-mos uma arquitetura
multi-tenant no projeto?

View Slide

View Slide

Multi-tenant
→ Não havíamos pensado nisso

View Slide

Nada parecia adequado, mas...
o que realmente precisava ser feito?

View Slide

O que realmente precisava ser feito?
→ Alterar drawables Android
→ Alterar resources iOS
→ Alterar AndroidManifest.xml
→ Alterar Info.plist
→ Alterar Entitlements.plist

View Slide

→ Alterar constantes - classe C#
→ Alterar styles - resource dictionary

View Slide

A solução que deu certo:
Criar um script de build
Mas como isso funciona??

View Slide

Iniciamos com um script simples que
alterava as imagens dos clientes

View Slide

Mas antes, foi necessário
padronizar algumas coisas...

View Slide

Padronizações - parte I
→ Criamos uma pasta para armazenar as imagens
especíﬁcas de cada cliente

View Slide

Padronizações - parte I
Solução
└─── Core
└─── Droid
└─── iOS
└─── Build
│ └─── script.sh
│ └─── Clientes
│ └─── Cliente1
│ │ └─── Droid
│ │ │ └─── arquivo1.png
│ │ │ └─── arquivo2.png
│ │ │
│ │ └─── iOS
│ │ └─── arquivo1.png
│ │ └─── arquivo2.png
│ │
│ └─── Cliente2
│ └─── ...

View Slide

Início do script
#!/bin/bash
# ./Build/script.sh
SOLUTION_DIR=/diretorio/projeto
CLIENTE=Cliente1

View Slide

Início do script
#!/bin/bash
CLIENTE=Cliente1
cp ORIGEM DESTINO

View Slide

Início do script
#!/bin/bash
CLIENTE=Cliente1
cp $SOLUTION_DIR/Build/Clientes/$CLIENTE/Droid/Resources/drawable/*.png

View Slide

Início do script
#!/bin/bash
CLIENTE=Cliente1
cp $SOLUTION_DIR/Build/Clientes/$CLIENTE/Droid/Resources/drawable/*.png \
$SOLUTION_DIR/Droid/Resources/drawable/

View Slide

Início do script
#!/bin/bash
CLIENTE=Cliente1
cp $SOLUTION_DIR/Build/Clientes/$CLIENTE/Droid/Resources/drawable-hdpi/*.png \
$SOLUTION_DIR/Droid/Resources/drawable-hdpi/

View Slide

Início do script
#!/bin/bash
CLIENTE=Cliente1
cp $SOLUTION_DIR/Build/Clientes/$CLIENTE/iOS/Assets.xcassets/AppIcon.appiconset/*.png \
$SOLUTION_DIR/iOS/Assets.xcassets/AppIcon.appiconset/

View Slide

Início do script
#!/bin/bash
CLIENTE=Cliente1
cp $SOLUTION_DIR/Build/Clientes/$CLIENTE/iOS/Assets.xcassets/LaunchImage.launchimage/*.png \
$SOLUTION_DIR/iOS/Assets.xcassets/LaunchImage.launchimage/

View Slide

Início do script
#!/bin/bash
CLIENTE=Cliente1
cp $SOLUTION_DIR/Build/Clientes/$CLIENTE/iOS/Assets.xcassets/LaunchImage.launchimage/*.png \
$SOLUTION_DIR/iOS/Assets.xcassets/LaunchImage.launchimage/
cp $SOLUTION_DIR/Build/Clientes/$CLIENTE/iOS/Resources/*.png \
$SOLUTION_DIR/iOS/Resources/

View Slide

→
✅
Alterar drawables Android
→
✅
Alterar resources iOS
→ Alterar AndroidManifest.xml

View Slide

Continuação do script...
→ Alterar atributos do AndroidManifest.xml
→ android:label
→ android:versionName
→ package

View Slide

Continuação do script -
AndroidManifest.xml

xmlns:android="http://schemas.android.com/apk/res/android"
android:versionName="1.4"
package="com.ionixjunior.app"
android:versionCode="4"
>

View Slide

AndroidManifest.xml
#!/bin/bash
sed

View Slide

AndroidManifest.xml
#!/bin/bash
sed 's'

View Slide

AndroidManifest.xml
#!/bin/bash
sed 's/SEARCH/REPLACE/'

View Slide

AndroidManifest.xml
#!/bin/bash
sed 's#SEARCH#REPLACE#'

View Slide

AndroidManifest.xml
#!/bin/bash
sed 's%SEARCH%REPLACE%'

View Slide

AndroidManifest.xml
#!/bin/bash
sed 's/SEARCH/REPLACE/'

View Slide

AndroidManifest.xml
#!/bin/bash
sed 's/SEARCH/REPLACE/' ARQUIVO_DESTINO

View Slide

AndroidManifest.xml
#!/bin/bash
sed 's/REGEX_SEARCH/REGEX_REPLACE/' ARQUIVO_DESTINO

View Slide

AndroidManifest.xml
#!/bin/bash
sed -i '' 's/REGEX_SEARCH/REGEX_REPLACE/' ARQUIVO_DESTINO
!

View Slide

AndroidManifest.xml
#!/bin/bash
MANIFEST=$SOLUTION_DIR/Droid/Properties/AndroidManifest.xml
VERSION_NAME=1.5
APP_NAME=Ionix App Corp
PACKAGE=com.ionix.corp

View Slide

AndroidManifest.xml
#!/bin/bash
VERSION_NAME=1.5
sed -i '' 's/versionName="[0-9.]*"/versionName="'$VERSION_NAME'"/' $MANIFEST

View Slide

AndroidManifest.xml
#!/bin/bash
VERSION_NAME=1.5
sed -i '' 's/android:label="[a-zA-Zà-úÀ-Ú0-9 ]*"/android:label="'"$APP_NAME"'"/' $MANIFEST

View Slide

AndroidManifest.xml
#!/bin/bash
VERSION_NAME=1.5
sed -i '' 's/android:label="[a-zA-Zà-úÀ-Ú0-9 ]*"/android:label="'"$APP_NAME"'"/' $MANIFEST
sed -i '' 's/package="[a-zA-Z.]*"/package="'$PACKAGE'"/' $MANIFEST
!

View Slide

→
✅
→
✅
→
✅
Alterar AndroidManifest.xml

View Slide

→ Alterar atributos do Info.plist
→ CFBundleIdentiﬁer
→ CFBundleName
→ CFBundleShortVersionString

View Slide

Continuação do script - Info.plist

"-//Apple//DTD PLIST 1.0//EN"
"http://www.apple.com/DTDs/PropertyList-1.0.dtd"
>

CFBundleIdentifier
com.ionixjunior.app
CFBundleName
Ionix App
CFBundleShortVersionString
1.4

View Slide

#!/bin/bash
INFO_PLIST=$SOLUTION_DIR/iOS/Info.plist
VERSION_NAME=1.5

View Slide

#!/bin/bash
VERSION_NAME=1.5
plutil

View Slide

#!/bin/bash
VERSION_NAME=1.5
plutil -replace

View Slide

#!/bin/bash
VERSION_NAME=1.5
plutil -replace CFBundleIdentifier

View Slide

#!/bin/bash
VERSION_NAME=1.5
plutil -replace CFBundleIdentifier -string

View Slide

#!/bin/bash
VERSION_NAME=1.5
plutil -replace CFBundleIdentifier -string $PACKAGE

View Slide

#!/bin/bash
VERSION_NAME=1.5
plutil -replace CFBundleIdentifier -string $PACKAGE $INFO_PLIST

View Slide

#!/bin/bash
VERSION_NAME=1.5
plutil -replace CFBundleName -string $APP_NAME $INFO_PLIST

View Slide

#!/bin/bash
VERSION_NAME=1.5
plutil -replace CFBundleName -string $APP_NAME $INFO_PLIST
plutil -replace CFBundleShortVersionString -string $VERSION_NAME $INFO_PLIST

View Slide

→
✅
→
✅
→
✅
→
✅
Alterar Info.plist

View Slide

→ Alterar atributos do Entitlements.plist
→ aps-environment

View Slide

Continuação do script - Entitlements.plist

"http://www.apple.com/DTDs/PropertyList-1.0.dtd"
>

aps-environment
development

View Slide

Continuação do script - Entitlements.plist
#!/bin/bash
ENTITLEMENTS_PLIST=$SOLUTION_DIR/iOS/Entitlements.plist
APS_ENVIRONMENT=production
plutil -replace aps-environment -string $APS_ENVIRONMENT $ENTITLEMENTS_PLIST

View Slide

→
✅
→
✅
→
✅
→
✅
Alterar Info.plist
→
✅
Alterar Entitlements.plist
Mas ainda não acabou...

View Slide

→ Alterar constantes - classe C#

View Slide

Continuação do script - constantes
public static class AppConfig
{
public const string ApiUrl = "https://homol.app.com";
}

View Slide

Continuação do script - constantes
#!/bin/bash
APP_CONFIG=$SOLUTION_DIR/Core/AppConfig.cs
API_URL=https://prod.app.com
sed -i '' 's#ApiUrl = "[a-z:./]*"#ApiUrl = "'$API_URL'"#' $APP_CONFIG

View Slide

→
✅
Alterar constantes - classe C#

View Slide

Continuação do script - styles - resource
dictionary

xmlns="http://xamarin.com/schemas/2014/forms"
xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
x:Class="Core.App"
>

#3F51B5
#F90000

View Slide

Continuação do script - styles - resource
dictionary
#!/bin/bash
APP_XAML=$SOLUTION_DIR/Core/App.xaml
PRIMARY_COLOR=Green
SECONDARY_COLOR=#0000FF
sed -i '' 's/"PrimaryColor">[a-zA-Z0-9#]*"PrimaryColor">'$PRIMARY_COLOR'' $APP_XAML
sed -i '' 's/"SecondaryColor">[a-zA-Z0-9#]*"SecondaryColor">'$SECONDARY_COLOR'' $APP_XAML

View Slide

→
✅
Alterar constantes - classe C#
→
✅
Alterar styles - resource dictionary
!

View Slide

Pensa que acabou?

View Slide

Pensa que acabou?
#!/bin/bash
CLIENTE=Cliente1
VERSION_NAME=1.5
...
O que tem de "errado"?

View Slide

Pensa que acabou?
#!/bin/bash
CLIENTE=Cliente1
VERSION_NAME=1.5
...
As variáveis estão ﬁxas no script

View Slide

Aqui começa a loucura...

View Slide

Padronizações - parte II
→ Criamos um arquivo para armazenar as variáveis
do build
# ./Build/app.ini
CLIENTE = Cliente1
API_URL = https://prod.app.com
VERSION_NAME = 1.5
APP_NAME = Ionix App Corp
PACKAGE = com.ionix.corp

View Slide

→ No script principal, carregamos estas variáveis...
#!/bin/bash
APP_INI=$SOLUTION_DIR/Build/app.ini
CLIENTE=

View Slide

#!/bin/bash
CLIENTE=$()

View Slide

#!/bin/bash
CLIENTE=$(cat $APP_INI)
# Vai mostrar o conteúdo de todo o arquivo...

View Slide

#!/bin/bash
CLIENTE=$(cat $APP_INI | grep "CLIENTE = ")
# CLIENTE = Cliente1

View Slide

#!/bin/bash
CLIENTE=$(cat $APP_INI | grep "CLIENTE = " | awk)
#

View Slide

#!/bin/bash
CLIENTE=$(cat $APP_INI | grep "CLIENTE = " | awk '{print $0}')
# CLIENTE = Cliente1

View Slide

#!/bin/bash
# CLIENTE

View Slide

#!/bin/bash
# =

View Slide

#!/bin/bash
# Cliente1

View Slide

→ Outro exemplo...
#!/bin/bash
APP_NAME=

View Slide

#!/bin/bash
APP_NAME=$(cat $APP_INI)

View Slide

#!/bin/bash
APP_NAME=$(cat $APP_INI | grep "APP_NAME = ")
# APP_NAME = Ionix App Corp

View Slide

#!/bin/bash
APP_NAME=$(cat $APP_INI | grep "APP_NAME = " | awk '{print $3}')
# Ionix
Está faltando coisa aí...

View Slide

→ Vamos revisar...
#!/bin/bash
APP_NAME=$(cat $APP_INI | grep "APP_NAME = " | awk '{print $0}')

View Slide

→ Vamos revisar...
#!/bin/bash
APP_NAME=$(cat $APP_INI | grep "APP_NAME = " | awk '{print $3 " " $4 " " $5}')
# Ionix App Corp

View Slide

→ Como deixar isso dinâmico??
... awk '{print $3 " " $4 " " $5}'
# Ionix App Corp

View Slide

... awk '{ {out=$3} }'
# out = Ionix

View Slide

... awk '{ {out=$3}; for (i=4; i <= NF; i++) { } }'
# out = Ionix
# NF = number of fields = 5

View Slide

... awk '{ {out=$3}; for (i=4; i <= NF; i++) { out=out" "$i } }'
# out = Ionix
# out = Ionix App
# out = Ionix App Corp

View Slide

... awk '{{out=$3; for(i=4; i<=NF; i++) { out=out" "$i }; print out}}'
# Ionix App Corp
!

View Slide

#!/bin/bash
MANIFEST = $SOLUTION_DIR/Droid/Properties/AndroidManifest.xml
INFO_PLIST = $SOLUTION_DIR/iOS/Info.plist
ENTITLEMENTS_PLIST = $SOLUTION_DIR/iOS/Entitlements.plist
APP_CONFIG = $SOLUTION_DIR/Core/AppConfig.cs
CLIENTE = $(cat $APP_INI | grep "CLIENTE = " | awk '{print $3}')
API_URL = $(cat $APP_INI | grep "API_URL = " | awk '{print $3}')
VERSION_NAME = $(cat $APP_INI | grep "VERSION_NAME = " | awk '{print $3}')
APP_NAME = $(cat $APP_INI | grep "APP_NAME = " | awk '{{out=$3; for(i=4;i<=NF;i++){out=out" "$i}; print out}}')
PACKAGE = $(cat $APP_INI | grep "PACKAGE = " | awk '{print $3}')

View Slide

E para o Windows? Tem??

View Slide

Tem que criar o .bat

View Slide

Isso é automatizado?

View Slide

Não, mas vamos melhorar...
vamos conﬁgurar na IDE

View Slide

View Slide

Script
→ Ajustes no $SOLUTION_DIR
#!/bin/bash
...

View Slide

Script
→ Ajustes no $SOLUTION_DIR
#!/bin/bash
SOLUTION_DIR=$1
...

View Slide

Isso sempre vai executar
na minha máquina?

View Slide

Calma, agora que tudo vai ﬁcar mais legal...
Vamos integrar ao CI server

View Slide

Visual Studio App Center

View Slide

→ Muito fácil de usar
→ Ideal para quem está iniciando no mundo
DevOps
→ Poucos cliques e os problemas estão resolvidos

View Slide

→ Build
→ UI Test
→ Distribuir para grupos de testes e lojas
→ Diagnóstico de erros
→ Analytics
→ Push

View Slide

Conﬁgurando o build

View Slide

Conﬁgurando o
build
→ Conectar o repositório

View Slide

Conﬁgurando o
build
→ Escolher o projeto

View Slide

Conﬁgurando o
build
→ Branches serão listados

View Slide

Conﬁgurando o
build
→ Conﬁgurar os branches

View Slide

Mas como nosso script
lê as variáveis do App Center?

View Slide

Como nosso script lê as variáveis do App
Center?
→ Customizações precisaram ser feitas...

View Slide

Padronizações - parte III
→ O app.ini não deve ser versionado
→ Então podemos veriﬁcar se ele existe no script...

View Slide

#!/bin/bash
# Script antes
SOLUTION_DIR=$1

View Slide

#!/bin/bash
# Script depois :)
SOLUTION_DIR=$1
if [ -e "$APP_INI" ]
then
else
# Não precisa fazer nada, as variáveis já foram setadas :)
fi

View Slide

→ Ainda falta deixar dinâmico o $SOLUTION_DIR...
→ O App Center também tem suas próprias
variáveis de ambiente

View Slide

#!/bin/bash
# Script antes
SOLUTION_DIR=$1

View Slide

#!/bin/bash
# Script depois :)
if [ -n "$1" ]
then
SOLUTION_DIR=$1
else
SOLUTION_DIR=$APPCENTER_SOURCE_DIRECTORY
fi

View Slide

→ O App Center não vai achar esse script sozinho
→ É necessário criar o script post-clone / pre-
build / post-build

View Slide

Padronizações
- parte III
Solução
└─── Build
└─── Droid
│ └─── appcenter-post-clone.sh
│ └─── appcenter-pre-build.sh
│ └─── appcenter-post-build.sh
└─── iOS
└─── appcenter-post-clone.sh
└─── appcenter-pre-build.sh
└─── appcenter-post-build.sh

View Slide

#!/usr/bin/env bash
# Droid/appcenter-pre-build.sh
# iOS/appcenter-pre-build.sh
sh $APPCENTER_SOURCE_DIRECTORY/Build/script.sh
!

View Slide

Você pode acompanhar
o resultado da compilação

View Slide

View Slide

Sabia que você pode contribuir?

View Slide

Sabia que você pode contribuir?
→ Projeto App Center Build Scripts Examples
→ https://github.com/Microsoft/appcenter-build-
scripts-examples

View Slide

O processo ainda não acaba
O que vimos é o mais complicado
O restante é bem simples

View Slide

Publicando o app na loja

View Slide

Publicando o
app na loja
→ Conectar o projeto a loja
→ Google Play
→ Apple Store

View Slide

Publicando o
app na loja
→ Escolher onde publicar
→ Produção
→ Testes

View Slide

Publicando o
app na loja
→ Envie o APK ou IPA
→ Adicione o release notes
→ Ser feliz
!

View Slide

Publicando o
app na loja
→ Limitações no iOS: somente é
possível enviar release notes
em inglês
!

View Slide

Na palestra de hoje vimos que...
→ É possível compilar um app de forma dinâmica
→ Você vai se encher de repetir as mesmas tarefas
→ Precisamos fazer a máquina trabalhar mais
→ Automatização é tudo

View Slide

Ione Souza Junior
Desenvolvedor mobile @ Unimestre
@ionixjunior
[email protected]

View Slide

Scripts de build e servidores de CI: você nunca mais vai querer executar qualquer tarefa de forma manual

Scripts de build e servidores de CI: você nunca mais vai querer executar qualquer tarefa de forma manual

Ione Souza Junior

More Decks by Ione Souza Junior

Other Decks in Technology

Featured

Transcript