Xcode Build Automation & Distribution

A talk I gave at PhillyCocoa on the tools and caveats with automating your Xcode builds and distribution.

1. Build Automation & Distribution Matt Thomas
2. Why?
3. My company has over 50 apps on the App Store
4. 50+ Apps! • Bug Fixes • Timely Release of New Features
5. …but why should you? Computers were literally made for it!
6. Why You Should Automate Eliminate Environment Issues
7. Why You Should Automate Send Apps to Testers
8. Why You Should Automate Stay Focused on Coding
9. Why You Should Automate Continuous Integration?
10. How?
11. Building
12. xcodebuild
13. xcodebuild • Core to all automation • Installed with Xcode • xcodebuild -help & man xcodebuild
14. xcodebuild -usage xcodebuild -project <project> <buildactions> xcodebuild -scheme <scheme> <buildactions>
15. buildactions • clean • build • archive • install* • test* * Mac only you can specify multiple at once
16. xcodebuild info xcodebuild -list
17. xcodebuild info xcodebuild -showBuildSettings
18. xcodebuild info xcodebuild -showsdks
19. xcodebuild tips • Multiple Xcode Installs? • Use DEVELOPER_DIR environment variable to select.
20. xcodebuild tips • Error running xcodebuild? • Run xcodebuild -license and accept.
21. xcodebuild tips • More information • WWDC 2012 Session 404 - Building from the Command Line with Xcode
22. Distribution
23. Distributing to Testers • Device Needs to be Provisioned • (max 100) • User Needs Provisioning Profile
24. Distributing to Testers • A packaged app — .ipa file • Provisioning profile Email
25. How do I make .ipa? xcrun -sdk iphoneos PackageApplication \ <PRODUCT.app> \ -o <PRODUCT.ipa>
26. How do I make .ipa? xcrun -sdk iphoneos PackageApplication \ <PRODUCT.app> \ -o <PRODUCT.ipa> \ --sign <CODESIGN_IDENTITY> \ --embed <PROVISONING_PROFILE> re-sign the .ipa
27. OTA Install • Easiest User Experience • Annoying Setup • Bring your own server • Must use absolute URLs • No error messages, just “fails”
29. HTML Link <a href="itms-services://?action=download- manifest&url=http://foobar.com/ MyApp.plist">Download Me</a> MIME types application/octet-stream ipa text/xml plist Link itms-services://? action=download-manifest& url=http://foobar.com/MyApp.plist
30. Other Tools
31. xcodebuild-rb github.com/lukeredpath/xcodebuild-rb
32. gem install xcodebuild-rb • Rake interface for xcodebuild • Clean, Build, Archive • Shows Progress!
33. xcodebuild-rb example XcodeBuild::Tasks::BuildTask.new do |t| t.target = "MyApp" t.configuration = "Release" end rake xcode:cleanbuild Rakefile Terminal
34. shenzhen github.com/mattt/shenzhen
35. gem install shenzhen • command line tool: ipa • Clean, Build, Archive, Distribute • TestFlight • HockeyApp • FTP
36. shenzhen example ipa build \ --workspace MyApp.xcworkspace\ --scheme MyApp \ --configuration Release \ --clean \ --archive
37. shenzhen example ipa distribute:hockeyapp \ --token API_TOKEN \ --notes "New Stuff"
38. Jenkins + Xcode Plugin jenkins-ci.org wiki.jenkins-ci.org/display/JENKINS/Xcode+Plugin
40. Other Services
41. HockeyApp & TestFlight hockeyapp.net testflightapp.com
42. HockeyApp & TestFlight similarities • Easy OTA Distribution • Crash Reports • Analytics • Tester Feedback
43. HockeyApp & TestFlight differences • HockeyApp • More platforms (iOS, Android, Mac) • More API Access • TestFlight • Free
44. Continuous Integration Continuous Integration is a software development practice where members of a team integrate their work frequently… Each integration is verified by an automated build (including test) to detect integration errors as quickly as possible. martinfowler.com/articles/continuousIntegration.html
45. Continuous Integration • Automated Builds • With Testing • To Find Errors Quickly
46. The State of iOS Unit Testing
47. Unit Testing in Xcode
48. Unit Testing outside Xcode
49. Unit Testing outside Xcode is awful ‘test’ build action doesn’t work for iOS
50. Unit Testing outside Xcode is awful TEST_AFTER_BUILD=YES doesn’t work
51. Unit Testing outside Xcode is awful Can’t launch simulator from command line
52. Unit Testing outside Xcode is awful Hacks require editing an internal tool: <XCODE_DEVELOPER_DIR>/Tools/ RunPlatformUnitTests.include
53. New Testing Service Hoping to solve these issue
54. cisimple cisimple.com
55. cisimple • New continuous integration service for iOS & Android • Just entered public beta • GitHub, TestFlight, HockeyApp support
56. cisimple • Build each time commit is pushed • Run OCUnitTests • Run UIAutomation Instrument
57. Xcode Build Automation How it affected my work
58. Before Xcode Automation It took 2 developers 3 days to do all of our builds
59. After Xcode Automation 1 Developer 20 Minutes Spare Machine
60. Matt Thomas @mthomas codecaffeine.com