mirror of
https://github.com/platformio/platformio-core.git
synced 2025-10-20 09:45:23 +02:00
73 lines
2.5 KiB
ReStructuredText
73 lines
2.5 KiB
ReStructuredText
|
.. _ci_travis:
|
||
|
|
|
||
|
|
Travis CI
|
||
|
|
=========
|
||
|
|
|
||
|
|
`Travis CI <http://en.wikipedia.org/wiki/Travis_CI>`_ is an open-source hosted,
|
||
|
|
distributed continuous integration service used to build and test projects
|
||
|
|
hosted at `GitHub <http://en.wikipedia.org/wiki/GitHub>`_.
|
||
|
|
|
||
|
|
Travis CI is configured by adding a file named ``.travis.yml``, which is a
|
||
|
|
`YAML <http://en.wikipedia.org/wiki/YAML>`_ format text file, to the root
|
||
|
|
directory of the GitHub repository.
|
||
|
|
|
||
|
|
Travis CI automatically detects when a commit has been made and pushed to a
|
||
|
|
GitHub repository that is using Travis CI, and each time this happens, it will
|
||
|
|
try to build the project using :ref:`cmd_ci` command. This includes commits to
|
||
|
|
all branches, not just to the master branch. Travis CI will also build and run
|
||
|
|
pull requests. When that process has completed, it will notify a developer in
|
||
|
|
the way it has been configured to do so — for example, by sending an email
|
||
|
|
containing the build results (showing success or failure), or by posting a
|
||
|
|
message on an IRC channel. It can be configured to build project on a range of
|
||
|
|
different :ref:`platforms`.
|
||
|
|
|
||
|
|
Integration
|
||
|
|
-----------
|
||
|
|
|
||
|
|
Please put ``.travis.yml`` to the root directory of the GitHub repository.
|
||
|
|
|
||
|
|
.. code-block:: yaml
|
||
|
|
|
||
|
|
language: python
|
||
|
|
python:
|
||
|
|
- "2.7"
|
||
|
|
|
||
|
|
env:
|
||
|
|
- PLATFORMIO_CI_SRC=path/to/source/file.c
|
||
|
|
- PLATFORMIO_CI_SRC=path/to/source/file.ino
|
||
|
|
- PLATFORMIO_CI_SRC=path/to/source/directory
|
||
|
|
|
||
|
|
install:
|
||
|
|
- python -c "$(curl -fsSL https://raw.githubusercontent.com/platformio/platformio/master/scripts/get-platformio.py)"
|
||
|
|
|
||
|
|
script:
|
||
|
|
- platformio ci --board=TYPE_1 --board=TYPE_2 --board=TYPE_N
|
||
|
|
|
||
|
|
|
||
|
|
For more details as for PlatformIO build process please look into :ref:`cmd_ci`
|
||
|
|
command.
|
||
|
|
|
||
|
|
Examples
|
||
|
|
--------
|
||
|
|
|
||
|
|
1. Integration for `USB_Host_Shield_2.0 <https://github.com/felis/USB_Host_Shield_2.0>`_
|
||
|
|
project. The ``.travis.yml`` configuration file:
|
||
|
|
|
||
|
|
.. code-block:: yaml
|
||
|
|
|
||
|
|
language: python
|
||
|
|
python:
|
||
|
|
- "2.7"
|
||
|
|
|
||
|
|
env:
|
||
|
|
- PLATFORMIO_CI_SRC=examples/Bluetooth/PS3SPP/PS3SPP.ino
|
||
|
|
- PLATFORMIO_CI_SRC=examples/pl2303/pl2303_gps/pl2303_gps.ino
|
||
|
|
|
||
|
|
install:
|
||
|
|
- python -c "$(curl -fsSL https://raw.githubusercontent.com/platformio/platformio/master/scripts/get-platformio.py)"
|
||
|
|
- wget https://github.com/xxxajk/spi4teensy3/archive/master.zip -O /tmp/spi4teensy3.zip
|
||
|
|
- unzip /tmp/spi4teensy3.zip -d /tmp
|
||
|
|
|
||
|
|
script:
|
||
|
|
- platformio ci --lib="." --lib="/tmp/spi4teensy3-master" --board=uno --board=teensy31 --board=due
|