Continuous integration foriOS projects

Aleksandra Gavrilovska

Netcetera

355

2

AGENDA

> iOS App Distribution Process

> Practices of Continuous Integration

> Jenkins

– How to configure slave

– How to configure job

> Build system at Netcetera

– Overview of rake tasks

– Benefits

– Improvements

3

iOS App Distribution Process

4

Practices of Continuous Integration

> Maintain a code repository

> Automate the build

> Make the build self-testing

> Everyone commits to the baseline every day

> Every commit (to baseline) should be built

> Keep the build fast

> Test in a clone of the production environment

> Make it easy to get the latest deliverables

> Everyone can see the results of the latest build

> Automate deployment

5

overview

> Open source continuous integration service provider

> Runs in servlet container such as Apache Tomcat

> iOS Projects MUST be build on Mac

> Jenkins instances as slaves

6

Configuring Jenkins Mac Slave

7

Create New Job

> Properties that must be set

8

Custom build system

> Implemented in Ruby

> Rake wrapper around xcodebuild

– Rakefile

– Several Ruby scripts

– Included in our xCode project templates

9

Rakefile

xcode_project :"___PROJECTNAME___" do # The artifact_id is a alias for the main Xcode target artifact_id "___ARTIFACT_ID___” project_id "___PROJECT_ID___" group_id "___GROUP_ID___" svn "___SVN___"

release_destination "http://buildfs.group.nca/dav/projects/___PROJECTNAME___/release/" snapshot_destination "http://buildfs.group.nca/dav/projects/___PROJECTNAME___/snapshots/"

itunes_artwork "src/main/resources/iTunesArtwork”

adhoc_package "NetceteraAdhoc" do identity "iPhone Distribution: Netcetera AG" # by default the provisioning profile used will be src/packaging/ADHOC_PACKAGE_NAME.mobileprovision # you can override by using # provisioning_profile "path to provisioning profile" endend

Rake tasks

agavrilo-2:agavrilo$ rake –tasks

rake build # Invokes xcode build to compile the project

rake ci # Invoked by the CI system

rake clean # Cleans the project

rake package # Creates the packages

rake release # Performs a release

rake release:rollback # [TBD]

rake report # Reports to techISR.

rake symbolicate # Symbolicates the crash report provided under the REPORT variable.

rake test # Invokes The tests

rake uitest # Run Cucumber features

task "ci" => "deliver-snapshot”

task "deliver-snapshot" => "package”

task "package" => ["appstore-package", "adhoc-packages"]

10

11

Test execution

> rake test> GHUnit as testing framework

> Jenkins can run GHUnit tests– http://gabriel.github.com/gh-unit/docs/appledoc_include/guide_ci.html

> UnitTest target should Run Script

> Tests are executed on Simulator

> JUnit test result report is created (XML file)

> Reports to internal reporting tool

12

Packaging

> rake package

> ‘Release’ configuration must exist in project scheme

> Creates app store package

> .dSYM file is stored

> Creates adhoc packages by resigning the app store packages

– Decreases the build time

– App store and adhoc application are both identical!

13

Deployment

> rake delivery

> Deploys all artifacts to snapshot_destination

– All provisioning profiles

– App store build

– .dSYM package

– *.ipa packages

> Ready to be fetched for testing or submission in iTunes Connect

14

Debugging: Symbolicate crash

> rake symbolicate REPORT=path_to_report

– REPORT can be a path to directory

> Extract the uuid from the crash report

> find the appropriate (matching) build on the DAV server

"No snapshot can be found that matches uuid: #{uuid}, for architecture: #{arch}”

> download it

> unpack it

> symbolicate it

lines = File.readlines(report).map {|line| line.tr("\r\n", '')}

line = lines[lines.index("Binary Images:") + 1]

line.match(/armv[67] +<[0-9a-z]+>/)[0].split(' ').map {|entry| entry.tr("<>", '')}

15

Conclusion

> Benefits

– Not dependent on xCode version

– Control of the build process

– Control of the project state

– Applications are always ready to be tested

– Debugging

– Scalable and configurable build system•build of workspace•Installation of pods

> Improvements

– Installation of certificates in keychain

– Check for code duplicates

– Check style

16

Questions

Aleksandra Gavrilovska

Netcetera

aleksandra.gavrilovska@netcetera.com