Building iOS apps

Setting up an iOS app in Nevercode.

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

  1. Click Add a new app on Nevercode dashboard.
  2. Select the appropriate option for where your app repository is hosted. See Specifying app repository for details.
    If you selected Other and need to configure authentication method, see Authenticating repository access and Defining checkout URL for details.
That's how your dashboard looks like after you've signed up.

That's how your dashboard looks like after you've signed up.

Define build configuration

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.

  1. Select a branch from the dropdown that Nevercode should scan. Note that you can change the branch later if needed.
  2. 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:

  1. Select a project or a workspace. Projects are are containers for code, resources and different build settings. Workspaces are containers of different projects.
  2. 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.

Run your first build

That’s it!

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.

Building your application.

After 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.

Build log.

Build log.

Run tests

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.

Test view.

Test view.

Publish your build artefacts

Nevercode supports publishing your iOS applications to several distribution channel.

Manage build versions

To make your build version management easy, Nevercode exports two environment variables that you can use in your build scripts: NEVERCODE_BUILD and NEVERCODE_BUILD_NUMBER. You can read more about it from Incrementing iOS app version.

Building iOS apps

Setting up an iOS app in Nevercode.