how we integrate & deploy mobile apps with travis ci part 2

How we integrate & deploy Mobile Apps with Travis CIMarcio Klepacz, iOS Engineering @ GetYourGuide

Mobile Warsaw, Poland 2015

Overview

Who we are

Problem

Requirements

Solution

Result

Improving

Marcio Klepacz, GetYourGuide

Who we are

GetYourGuide Offers the Largest Travel

Activities Inventory Worldwide


800+

10,600+5,300+

800+

4,000+

2,000+

The Problem

Repetitive

Manual

We want to automate that

Fit our workflow

Developer Happiness


😄Develop

😊

Run

Tests

😐Configure

😒

Build

😠

Write

release

notes

😤

Upload,

notify

users,

etc.

The Requirements

Requirements


Automatically build and test on push

Fit into gitflow workflow (feature, develop and

release) branch

Produce binaries that can be tested (downloaded)

Requirements / Gitflow


Requirements / Summary


Build an Alpha App with Test Environment

Able to book with dummy credit card

Build a Beta App with the Live Environment

Real content

Build and test on every push

Distribute app to testers from release and develop branches

Relieve developers from repetitive manual tasks


XcodeServer

Jenkins Ship.io Travis CI Circle CI

iOS and Android

✘ ✔︎ ✔︎ ✔︎ ✔︎

Actionsspecific to branches

✔︎ ✔︎ ✔︎ ✔︎

✔︎

Build on push

✔︎ ✔︎ ✔︎ ✔︎ ✔︎

Big community

✔︎ ✔︎ ✘ ✔︎ ✘

Hosted ✘ ✘ ✔︎ ✔︎ ✔︎

The Solution

Travis


Hosted Continuous Integration service

Configuration file in your project (.travis.yml)

Define SDK, build env and output

custom scripts

Connected to Github

Triggers in every push and pull request

Available for many platforms

Travis Setup (.travis.yml)


It’s not using the iPhone SDK

code signing is needed

Doesn’t differentiate between branches

Doesn’t archive

Doesn’t distribute

language: objective-c

xcode_project: MyNewProject.xcodeproj

xcode_scheme: MyNewProjectSharedScheme

iPhone SDK

custom build per branch

generate .ipa

distribute

Import keys (import-keys.sh)

# 1. Create keychain

security create-keychain -p travis ios-build.keychain

# 2. Make as default

security default-keychain -s ios-build.keychain

# 3. Unlock keychain

security unlock-keychain -p travis ios-build.keychain

# 4. Add certificates to keychain

security import ./ios-travis-ci/certificates/dist.cer -k ios-build.keychain -T /usr/bin/codesign

security import ./ios-travis-ci/certificates/dist.p12 -k ios-build.keychain -P $KEY_DIST_PASSWORD -T /usr/bin/codesign

# 5. Copying provisioning profile to Travis

mkdir -p ~/Library/MobileDevice/Provisioning\ Profiles

cp ./ios-travis-ci/profiles/*.mobileprovision ~/Library/MobileDevice/Provisioning\ Profiles/


iPhone SDK


generate .ipa

distribute

Import keys (import-keys.sh)

# 1. Create keychain

security create-keychain -p travis ios-build.keychain

# 2. Make as default

security default-keychain -s ios-build.keychain

# 3. Unlock keychain

security unlock-keychain -p travis ios-build.keychain

# 4. Add certificates to keychain

security import ./ios-travis-ci/certificates/dist.cer -k ios-build.keychain -T /usr/bin/codesign

security import ./ios-travis-ci/certificates/dist.p12 -k ios-build.keychain -P $KEY_DIST_PASSWORD -T /usr/bin/codesign

# 5. Copying provisioning profile to Travis

mkdir -p ~/Library/MobileDevice/Provisioning\ Profiles

cp ./ios-travis-ci/profiles/*.mobileprovision ~/Library/MobileDevice/Provisioning\ Profiles/

⛔️️


iPhone SDK


generate .ipa

distribute

Security


You can encrypt environment variables using

Travis command line tool on your terminal:

~ $ travis encrypt ‘KEY_DIST_PASSWORD=abc123’ –add

Passing the option “--add” will automatically add the secure

key to your .travis.yml

env:

global:

- secure: Pz3cxDffsdafasf34324fdsf232fdsfdsf3fdsf

iPhone SDK


generate .ipa

distribute



Use iPhone SDK ✅

Doesn’t differentiate between branches

Doesn’t archive



env:

global:


before_script:

- ./scripts/import-key.sh

script:

- xctool -workspace MyNewProject.xcworkspace -scheme MySharedScheme -sdk iphoneos -configuration Beta

iPhone SDK


generate .ipa

distribute

Building (build_app.sh)

# 1.

xctool -workspace ${APP_NAME}.xcworkspace \

-scheme ${APP_NAME} \

-sdk iphonesimulator test

…

# 2.

export RELEASE_SUFFIX=".release”

# Bundle Identifier:

#

com.getyourguide.mobile.$(PRODUCT_NAME:rfc1034identifier)${BUNDLE_ID_SUFFIX}${RELEASE_

SUFFIX}

…

# 3

xctool -workspace ${APP_NAME}.xcworkspace -scheme ${APP_NAME} \

-sdk iphoneos \

-configuration ${APP_BUILD_CONFIG} \

OBJROOT=$PWD/build \

SYMROOT=$PWD/build


iPhone SDK


generate .ipa

distribute



Use iPhone SDK ✅

Differentiate between branches ✅

Doesn’t archive


…

global:


matrix:

- APP_BUILD_CONFIG=Debug

- APP_BUILD_CONFIG=Beta

before_script:


script:

- ./scripts/build-app.sh

iPhone SDK


generate .ipa

distribute

# 1.

xcrun -sdk iphoneos PackageApplication \

-v ”$BUILD_DIR/$APP_NAME.app" \

-o ”$BUILD_DIR/$APP_NAME.ipa" \

--sign "$DEVELOPER_NAME" \

--embed ”$PROVISIONING_PROFILE"

…

# 2.

release_notes=`git log --since=1.week --pretty=format:"%an - %s"`

curl \

-F status="2" \

-F notify="0" \

-F release_type="2" \

-F notes="$release_notes" \

-F notes_type="0" \

-F "ipa=@$outputdir/$APP_NAME.ipa" \

-F "mobileprovision=@$provisioning_profile" \

-H "X-HockeyAppToken: ${HOCKEY_APP_TOKEN}" \

https://rink.hockeyapp.net/api/2/apps/upload # Uploading to HockeyApp

Archiving and uploading

(archive_and_upload.sh)


iPhone SDK


generate .ipa

distribute



Use iPhone SDK ✅

Differentiate between branches ✅

Archive ✅

Distribute ✅


env:

global:


before_script:


script:

- ./scripts/build-app.sh

after_success:

- ./scripts/archive_and_upload.sh

iPhone SDK


generate .ipa

distribute

Move the scripts away from the app

repository (Optional)


Maintenance 👍

Reusable 👍

Slower builds 👎

…

git:

submodules: false

before_install:

- git submodule init ios-travis-ci

- git submodule update --remote --merge ios-travis-ci

Result


Automate tasks

App is distributed

No manual configuration

Different actions between branches

5 different apps to test concurrently

(@banaslee’s phone)

Improving

Some pain left


Provisioning profile included on project 👎

Very long shell script files 👎

Can’t scale 👎

Very Travis dependent👎

Fastlane by @KrauseFx


Lets you define and run your deployment

pipelines for different environments.

Ruby gem

Powerful toolchain

Automates certificates and

prov.profile installs

Flexible

Open source

Fastlane / Example


# ../fastlane/Fastfile

#...

lane :deploy do

# Installing certificates

cert( development: true, username: "[email protected]")

# Fetching and installing proviosning profiles

sigh( adhoc: true, force: true, filename: "myFile.mobileprovision")

# Build project

gym( scheme: "MyApp", workspace: "MyApp.xcworkspace", configuration: ENV["APP_BUILD_CONFIG"])

# Shipping

hockey( api_token: '...', ipa: './app.ipa', notes: "Changelog")

end

#...

Fastlane / Example .travis.yml



env:

global:


script:

- bundle exec fastlane deploy

Scalable 👍

Faster 👍

Focused on Apple environment 👎

Thanks for your time@marciok and [email protected]

References


Travis CI for iOS - Mattes Groeger

johanneswuerbach / .travis.yml - Johannes Würbach

The OS X Build Environment - Travis CI

Fastlane - Felix Krause

http://www.objc.io/issue-6/travis-ci.html

https://gist.github.com/johanneswuerbach/5559514

http://docs.travis-ci.com/user/osx-ci-environment/

https://github.com/KrauseFx/fastlane

how we integrate & deploy mobile apps with travis ci part 2

Technology