Using Continuous Integration with Xamarin Apps Senior Engineer, Olo @gshackles [email protected] Greg Shackles 

Ship It A Cautionary Tale 

No content

No content

No content

No content

No content

No content

No content

The Worst by Vitruvius This app is just…the worst. 

No content

How can we deliver Continuous Awesomeness? 

Continuous Integration Let your tools work for you on every commit 

What is Continuous Integration? 

What is Continuous Integration? VCS 

What is Continuous Integration? VCS CI Server 

What is Continuous Integration? VCS CI Server CI Agent 

What is Continuous Integration? VCS CI Server CI Agent 

Options TFS Jenkins …and more 

Delivery TestFlight HockeyApp …and more 

CI with Xamarin Apps 

Build Agent Setup 

Build Agent Setup ■ OS X machine for iOS builds - Mac Mini works well 

Build Agent Setup ■ OS X machine for iOS builds - Mac Mini works well ■ OS X or Windows machine for Android 

Build Agent Setup ■ OS X machine for iOS builds - Mac Mini works well ■ OS X or Windows machine for Android ■ Install platform SDKs 

Build Agent Setup ■ OS X machine for iOS builds - Mac Mini works well ■ OS X or Windows machine for Android ■ Install platform SDKs ■ Install Xamarin 

Build Agent Setup ■ OS X machine for iOS builds - Mac Mini works well ■ OS X or Windows machine for Android ■ Install platform SDKs ■ Install Xamarin ■ Install agent software for chosen CI server 

iOS: Build mdtool build -t:Build -c:AppStore MyAwesomeApp.sln /Applications/Xamarin Studio.app/Contents/MacOS/mdtool 

iOS: Package zip -r -y MyAwesomeIosApp.zip path/to/MyAwesomeIosApp.app 

Android: Build Windows: msbuild OS X: xbuild xbuild build /t:Build /p:Configuration=Release MyAwesomeApp.sln 

Android: Package (Part 1) Windows: msbuild OS X: xbuild xbuild build /t:PackageForAndroid /p:Configuration=Release MyAwesomeAndroidApp.csproj 

Android: Package (Part 2) jarsigner -sigalg SHA1withRSA -digestalg SHA1 -keystore -storepass -signedjar path/to/MyAwesomeAndroidApp-Signed.apk path/to/MyAwesomeAndroidApp.apk 

Android: Package (Part 2) jarsigner -sigalg SHA1withRSA -digestalg SHA1 -keystore -storepass -signedjar path/to/MyAwesomeAndroidApp-Signed.apk path/to/MyAwesomeAndroidApp.apk zipalign -f -v 4 path/to/MyAwesomeAndroidApp-Signed.apk path/to/MyAwesomeAndroidApp-Aligned.apk 

Package Restore NuGet mono NuGet.exe restore path/to/App.sln 

Package Restore NuGet mono NuGet.exe restore path/to/App.sln Xamarin Components mono xamarin-component.exe restore path/to/App.sln 

Xamarin.UITest Run using any NUnit runner nunit-console4 path/to/TestAssembly.dll -xml testresults.xml 

Pro Tip: Allow Build to Access UI jetbrains.teamcity.BuildAgent.plist 

Pro Tip: Allow Build to Access UI jetbrains.teamcity.BuildAgent.plist ■ Set username UserName your_user 

Pro Tip: Allow Build to Access UI jetbrains.teamcity.BuildAgent.plist ■ Set username UserName your_user ■ Copy to /Library/LaunchAgents 

TestCloud Run your UI tests on hundreds of devices test-cloud.exe submit path/to/myapp.[ipa|apk] --devices --series "master" --locale "en_US" --assembly-dir “path/to/bin“ --nunit-xml testresults.xml 

FAKE #r @"FAKE/tools/FakeLib.dll"
 #load "build-helpers/iOS.fsx"
 
 open Fake
 
 Target "ios-build" (fun () ->
 iOS.build "Debug|iPhoneSimulator"
 )
 
 Target "ios-adhoc" (fun () ->
 iOS.build "AdHoc|iPhone"
 )
 
 Target "ios-testflight" (fun () ->
 iOS.publishToTestFlight()
 )
 
 "ios-adhoc"
 ==> "ios-testflight"
 
 RunTarget()
 

FAKE #r @"FAKE/tools/FakeLib.dll"
 #load "build-helpers/iOS.fsx"
 
 open Fake
 
 Target "ios-build" (fun () ->
 iOS.build "Debug|iPhoneSimulator"
 )
 
 Target "ios-adhoc" (fun () ->
 iOS.build "AdHoc|iPhone"
 )
 
 Target "ios-testflight" (fun () ->
 iOS.publishToTestFlight()
 )
 
 "ios-adhoc"
 ==> "ios-testflight"
 
 RunTarget()
 TeamCityHelper.PublishArtifact "path/to/App.zip"
 Helpers 

FAKE #r @"FAKE/tools/FakeLib.dll"
 #load "build-helpers/iOS.fsx"
 
 open Fake
 
 Target "ios-build" (fun () ->
 iOS.build "Debug|iPhoneSimulator"
 )
 
 Target "ios-adhoc" (fun () ->
 iOS.build "AdHoc|iPhone"
 )
 
 Target "ios-testflight" (fun () ->
 iOS.publishToTestFlight()
 )
 
 "ios-adhoc"
 ==> "ios-testflight"
 
 RunTarget()
 TeamCityHelper.PublishArtifact "path/to/App.zip"
 TeamCityHelper.sendTeamCityNUnitImport "results.xml"
 Helpers 

FAKE #r @"FAKE/tools/FakeLib.dll"
 #load "build-helpers/iOS.fsx"
 
 open Fake
 
 Target "ios-build" (fun () ->
 iOS.build "Debug|iPhoneSimulator"
 )
 
 Target "ios-adhoc" (fun () ->
 iOS.build "AdHoc|iPhone"
 )
 
 Target "ios-testflight" (fun () ->
 iOS.publishToTestFlight()
 )
 
 "ios-adhoc"
 ==> "ios-testflight"
 
 RunTarget()
 TeamCityHelper.PublishArtifact "path/to/App.zip"
 TeamCityHelper.sendTeamCityNUnitImport "results.xml"
 TestFlight(fun p ->
 {p with
 File: "path/to/App.app"
 Notes: "Now with 42% more awesome!"
 })
 Helpers 

FAKE #r @"FAKE/tools/FakeLib.dll"
 #load "build-helpers/iOS.fsx"
 
 open Fake
 
 Target "ios-build" (fun () ->
 iOS.build "Debug|iPhoneSimulator"
 )
 
 Target "ios-adhoc" (fun () ->
 iOS.build "AdHoc|iPhone"
 )
 
 Target "ios-testflight" (fun () ->
 iOS.publishToTestFlight()
 )
 
 "ios-adhoc"
 ==> "ios-testflight"
 
 RunTarget()
 TeamCityHelper.PublishArtifact "path/to/App.zip"
 TeamCityHelper.sendTeamCityNUnitImport "results.xml"
 HipChatNotification(fun p ->
 {p with 
 From = "App BuildBot"
 Message = "Published to TestFlight"
 Color = "green"
 })
 TestFlight(fun p ->
 {p with
 File: "path/to/App.app"
 Notes: "Now with 42% more awesome!"
 })
 Helpers 

FAKE Helpers for Xamarin “path/to/MyApp.sln“ |> RestoreComponents (fun defaults -> {defaults with ToolPath = “...” })
 

FAKE Helpers for Xamarin “path/to/MyApp.sln“ |> RestoreComponents (fun defaults -> {defaults with ToolPath = “...” })
 iOSBuild (fun defaults ->
 {defaults with
 ProjectPath = “path/to/MyApp.sln”
 Configuration = “AppStore”
 Target = “Build”
 })
 

FAKE Helpers for Xamarin iOSBuild (fun defaults ->
 {defaults with
 ProjectPath = “path/to/MyApp.sln”
 Configuration = “AppStore”
 Target = “Build”
 })
 “path/to/MyApp.sln“ |> RestoreComponents (fun defaults -> {defaults with ToolPath = “...” })
 AndroidPackage (fun defaults ->
 {defaults with
 ProjectPath = “path/to/MyApp.csproj”
 })
 |> AndroidSignAndAlign (fun defaults ->
 {defaults with
 KeystorePath = “...”
 KeystorePassword = “...”
 KeystoreAlias = “...”
 })
 |> fun file -> TeamCityHelper.PublishArtifact file.FullName
 

How We Work At 

No content

No content

No content

Git / GitHub ■ Feature branches ■ Every app builds on every branch ■ Any branch can be pushed to TestFlight ■ Pull Requests for code review 

Test-Driven Core 

UI Tests and Test Cloud 

Deployment and Distribution 

Deployment and Distribution 

Deployment and Distribution 

Continuous Monitoring 

Demo github.com/gshackles/xamarin-ci-sample 

Questions? @gshackles [email protected] ! github.com/gshackles speakerdeck.com/u/gshackles