Post on 27-Jun-2015
Continuous integration for iOS 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"! end!end!
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