Xcode Builder Step

Performs Xcode build, test, analyze or archive action, based on it's input.

This Step is part of the Open StepLib, you can find its StepLib page here.

Install this Step on your own machine

Just clone this git repository and you can start using it.

Run this Step on your own machine

Steps get their inputs through Environment Variables.
The Step's inputs are described in the step.yml Step
description file.

To run a Step locally you have to define it's
inputs (environment variables) before you could run
the Step.

A simple way to do this in your Command Line / Terminal
is to call it like this:

cd path/to/step/directory

(
	export INPUT_VAR_1="My value 1"
	export INPUT_VAR_2="My value 2"
	...
	bash step.sh
)

Including the environment variable definitions
in a (...) block helps to keep your
Command Line / Terminal environment clean, those
input environments are only available
inside the (...) block.

If you plan to test it multiple times you can
save this as a shell script
and simply call it as many times as you want to.

Contributing to this Step

1. Fork this repository
2. Create your feature branch (git checkout -b my-new-feature)
3. Commit your changes (git commit -am 'Add some feature')
4. Push to the branch (git push origin my-new-feature)
5. Create a pull request

Create your own Step:

1. Create a new repository on GitHub
2. Copy the files from the step-template repository
3. Commit and push it

Hurray, you just created your first Step repository!
You can now start coding and when you're ready
you can submit your Step to the Open Step Library.

You can find more information about the submission process below,
in the "How to submit your Step into the Open Step Library" section.

Step Repository Structure

step.sh

This is the entry point of the Step. A StepLib
system will execute this file when it runs the Step.
You can run other scripts and programs from
step.sh. For example if you want to write your
Step in ruby then all you have to include in the step.sh
file is the code to run your own ruby script,
something like this:

#!/bin/bash

THIS_SCRIPT_DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"

ruby "${THIS_SCRIPT_DIR}/my_ruby_script.rb"
exit $?

inputs: a Step should get it's inputs through
environment variables. These inputs can be (and should be)
specified in the step.yml description of the Step.

exit code: the exit code generated by step.sh
is interpreted as the success/failure code of the whole Step.
If it returns 0 the Step will be considered as successful.
If it returns with a greater than 0 exit code then
the Step is considered to be failed.

step.yml

Description of the step in YAML format.

Specifies information for StepLib users like what platforms
the Step supports, what's the official website of the
Step, where can a user find the Step's code and
where can a user fork the Step.

Also defines an input list for the Step which then
can be presented as User Interface for the Step
and a StepLib compatible system can interpret these
inputs and map the user input values to
environment variables which will be available for the Step.

For a full description of the step.yml description
file see the documentation on GitHub: https://github.com/steplib/steplib/blob/master/docs/step_format.md

LICENSE

We don't accept steps into the StepLib without a license included in it!
Read more about why it's important to have a license file
in your open source repository on GitHub: https://github.com/steplib/steplib/blob/master/templates/step/LICENSE.

README.md

Technically README is not required but we strongly suggest
against not using one.

It can be a very simple description of what your Step does,
in just a couple of sentences.

Best practice is to include information about how
someone else can contribute to the development of the Step.

You can also include a link to the StepLib website, including your
own Step's page on StepLib (once it's submitted
into the Open StepLib collection), something like this:

This Step is part of the Open StepLib,
you can find its page on StepLib here.

How to submit your Step into the Open Step Library

To submit a Step to the Open Step Library
you have to create a Pull Request in the StepLib's spec repository
and include your step's step.yml description file
in the steps/ folder.

1. Create your Step repository as described above.
2. Fork the StepLib spec repository: https://github.com/steplib/steplib
3. Create a new folder inside the steps/ folder (in your forked StepLib spec repository) if it's the first version of your Step. (Example path: steps/my-step). Note: The name of the folder will be the ID of your Step.
4. Create a folder inside your step's folder with the name of a version tag you added to your Step repository. (Example path: steps/my-step/1.0.0). You have to actually use this tag in your repository. When a user wants to use this version of your Step the StepLib system will try to clone your Step repository with the specified version tag!
5. Copy your step.yml into this version folder (Example path: steps/my-step/1.0.0/step.yml)
6. Create and send a Pull Request

Before you submit your Step into a Step Library you should test it in a StepLib compatible system.
You can use a free Bitrise account to test your Step.