TeamCity Companion is the premier iOS app to review and manage your Continuous Integration builds on the go. While TeamCity is a great and easy to use CI server, keeping up with your builds is not as easy as it could be.
TeamCity Companion provides a native user interface optimized for easy consumption, enabling you to review build progress, build results, tests, logs, history and even run builds from truly anywhere.
The core features of TeamCity Companion are:
- Support for multiple TeamCity servers
- Single sign-on
- View and filter projects and builds
- View build results, changes, artifacts and logs
- View test results
- View build history and charts
- View self-updating build radiator
- Start builds, optionally with custom parameters
- Flag build types and set up notifications for build failures
You can configure any number of TeamCity servers, so it is easy to keep track of your open-source projects
that might be hosted and tested elsewhere as well as your day-job builds at the same time.
Your credentials are securely saved in the ios Keychain and used only to authenticate to the configured TeamCity server. You can hop right on to the server from the app (e.g. to review build result details) without having to re-authenticate - never type in your user name or password again.
All projects are listed in alphabetical order, optionally filtered to only show "tagged" projects.
A project can be tagged by toggling its tag indicator.
Each build displays additional information if available:
- Name and last result (failure or success) of each build type for each expanded project
- Time the build ran
- Build duration (TeamCity 8.1+)
- Status text (TeamCity 8.1+)
- An indicator for builds currently still running and their pending result
Tapping a build result selects it and an actions toolbar is shown on the bottom. The toolbar gives you quick access to following capabilities:
- View the build log / build results details
- Show test results
- Trigger a new build of the same type
- View build history
- Show build radiator
- Flag or unflag this build type
Review the build summary, all changes that were introduced in the build, the produced build artifacts as well as the full build log in a single view. To dive in deeper you can view the build or the changes within a web view that automatically authenticates you with your TeamCity server. From here you can navigate freely within your TeamCity server web UI if needed.
Review the test results of the selected build.
Review the recent build history either as a tabular view or as a chart.
To keep up with a build or a build chain while it is running you can use the build radiator view. The build radiator is self-updating with the current status of the build.
- Overall progress based on the expected run time as determined by TeamCit
- Current success / failure status (green is passing)
- Any status and progress text for the current step (e.g. number of completed tests)
- Status of all of the build dependencies
- Final build results
Flag any build type so you can keep track of it in a the special flagged build types view that gives you a concise summary of the last outcome of these builds only. This is a great way to keep up-to-date on the builds that are most relevant to you, regardless of the project they are in.
Review the latest activity of build results on all serves. Ordered by time, and optionally only showing failing builds this gives you a quick overview of how your TeamCity servers are doing currently. This can be useful if you are involved in many projects, or are maintaining build environments.
Version 1.1. of the app has been tested against TeamCity servers running versions 7.1.3, 8.0.4 and 8.1.
Version 2.0. of the app has been tested against TeamCity servers running versions 8.0.4 and 8.1.4.
Version 2.1. of the app has been tested against TeamCity servers running versions 8.0.4 and 9.0.1.
Contact TeamCityCompanion@gmail.com for general feedback, questions, feature requests or bug reports.
Current feature requests and bug reports can be reviewed on the TeamCity Companion Trello board.And of course, if you like the app please take the time to review and rate it in the app store (I hear it increases your build pass rate) - thank you!