Why a mobile app?
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.
Features
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
Support for multiple TeamCity servers
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.
Single Sign-On
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.
View and filter projects and builds
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 build results
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 test results
Review the test results of the selected build.
Review build history
Review the recent build history either as a tabular view or as a chart.
View build radiator
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.
This includes:
- 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 build types
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.
View build stream
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.
Tested TeamCity server versions
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.
Support or Contact
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!