This tutorial guides you through setting up your iOS app in Nevercode. Nevercode doesn't require any kind of additional software from your side and you don’t even have to write any tedious configuration files full of technical boilerplate. We’ll scan your repository and from what you have there our builders find everything they need. You’ll just have to confirm what configuration you want to build.
The guide covers how to:
- Specify app repository
- Define build configuration
- Set up Git hooks
- Run tests
- Publish your build artefacts
- Manage build versions
That's how your dashboard looks like after you've signed up.
After specifying app repository, Nevercode takes a first look at it by listing the
branches in this repository. The next step for you is to select the branch you want Nevercode to scan for projects from.
- Select a branch from the dropdown that Nevercode should scan. Note that you can change the branch later if needed.
- Click Scan branch. Nevercode scans the repository from the specified branch. This includes cloning the repository, looking for projects from it and searching for the configurations.
All these actions can be monitored real-time from your browser via the live log window.
If you are using Cocoapods to manage the dependencies of your project, please refer to the Cocoapods section before continuing to read this section!
Once scanning the branch has finished, you need to do the following:
- Select a project or a workspace. Projects are are containers for code, resources and different build settings. Workspaces are containers of different projects.
- Based on the previous selection of project or workspace, you will need to select either a Target (projects) or a Scheme (workspaces).
Now that you are done with the build configuration, all that is left to provide the corresponding code signing files.
Now there’s only one more step left to build your iOS app with Nevercode and that’s clicking the Save and start build button.
This action will show you the projects dashboard where you can see the app you just added already being built.
Building your application.
git clone Nevercode will automatically find the name and icon of your app from the repo and updates your project accordingly. To see the progress of your build, just click the “View build” you’ll be shown the build overview, where you can see the real time logs of your build.
Setting up testing in Nevercode is 100% automatic. When you submit your repository, we scan the selected configuration for tests, and if there are any tests present, we run them for every push.
Nevercode currently only supports running XCTests. Additionally, the tests must be a part of your scheme in Xcode, otherwise we cannot detect and run them automatically.
The test report screen shows you a simple overview of all passed and failed tests including the failure reason so you can quickly identify what’s broken.
Nevercode supports publishing your iOS applications to several distribution channel.
To make your build version management easy, Nevercode exports two environment variables that you can use in your build scripts:
NEVERCODE_BUILD_NUMBER. You can read more about it from Incrementing iOS app version.