Improve base package manager; VCS and package ID support

This commit is contained in:
Ivan Kravets
2016-08-01 17:05:48 +03:00
parent e3bf12f65c
commit e60c2a6ba1
13 changed files with 668 additions and 433 deletions
+37 -23
View File
@@ -22,7 +22,7 @@ Usage
.. code-block:: bash
# install platform by name
platformio platform install [OPTIONS] PLATFORM
platformio platform install [OPTIONS] [PLATFORM...]
# install specific platform version using Semantic Versioning
platformio platform install [OPTIONS] PLATFORM@X.Y.Z
@@ -45,10 +45,16 @@ There are several predefined aliases for packages, such as:
Local
~~~~~
PlatformIO supports installing development platform from local directory. Here
is supported form:
PlatformIO supports installing development platform from local directory or
archive. Need to use ``file://`` prefix before local path. Also, platform
directory or archive should contain ``platform.json`` manifest.
* ``file:///local/path/to/the/platform/dir``
* ``file:///local/path/to/the/platform.zip``
* ``file:///local/path/to/the/platform.tar.gz``
Remote
~~~~~~
VCS
~~~
@@ -135,34 +141,38 @@ Examples
.. code-block:: bash
$ platformio platform install atmelavr
Installing platform atmelavr @ latest:
PlatformManager: Installing atmelavr
Downloading...
Unpacking [####################################] 100%
Installing package tool-scons @ >=2.3.0,<2.6.0:
atmelavr @ 0.0.0 has been successfully installed!
PackageManager: Installing tool-scons @ >=2.3.0,<2.6.0
Downloading [####################################] 100%
Unpacking [####################################] 100%
Installing package toolchain-atmelavr @ ~1.40801.0:
tool-scons @ 2.4.1 has been successfully installed!
PackageManager: Installing toolchain-atmelavr @ ~1.40801.0
Downloading [####################################] 100%
Unpacking [####################################] 100%
toolchain-atmelavr @ 1.40801.0 has been successfully installed!
The platform 'atmelavr' has been successfully installed!
The rest of packages will be installed automatically depending on your build environment.
2. Install :ref:`platform_atmelavr` with ``uploader`` utility only and skip
default packages
.. code-block:: bash
$ platformio platform install atmelavr --skip-default-package --with-package=uploader
Installing platform atmelavr @ latest:
PlatformManager: Installing atmelavr
Downloading [####################################] 100%
Unpacking [####################################] 100%
Installing package tool-micronucleus @ ~1.200.0:
atmelavr @ 0.0.0 has been successfully installed!
PackageManager: Installing tool-micronucleus @ ~1.200.0
Downloading [####################################] 100%
Unpacking [####################################] 100%
Installing package tool-avrdude @ >=1.60001.0,<1.60101.0:
tool-micronucleus @ 1.200.0 has been successfully installed!
PackageManager: Installing tool-avrdude @ ~1.60001.0
Downloading [####################################] 100%
Unpacking [####################################] 100%
tool-avrdude @ 1.60001.1 has been successfully installed!
The platform 'atmelavr' has been successfully installed!
The rest of packages will be installed automatically depending on your build environment.
@@ -171,27 +181,31 @@ Examples
.. code-block:: bash
$ platformio platform install https://github.com/platformio/platform-atmelavr.git
Installing platform https://github.com/platformio/platform-atmelavr.git @ latest:
PlatformManager: Installing platform-atmelavr
git version 2.7.4 (Apple Git-66)
Cloning into '/Users/ikravets/.platformio/platforms/installing-XMIsAE-package'...
remote: Counting objects: 172, done.
remote: Compressing objects: 100% (51/51), done.
remote: Total 172 (delta 109), reused 168 (delta 109), pack-reused 0
Receiving objects: 100% (172/172), 38.18 KiB | 0 bytes/s, done.
Resolving deltas: 100% (109/109), done.
Cloning into '/Volumes/MEDIA/tmp/pio3_test_projects/arduino-digihead-master/home_dir/platforms/installing-U3ucN0-package'...
remote: Counting objects: 176, done.
remote: Compressing objects: 100% (55/55), done.
remote: Total 176 (delta 114), reused 164 (delta 109), pack-reused 0
Receiving objects: 100% (176/176), 38.86 KiB | 0 bytes/s, done.
Resolving deltas: 100% (114/114), done.
Checking connectivity... done.
Submodule 'examples/arduino-external-libs/lib/OneWire' (https://github.com/PaulStoffregen/OneWire.git) registered for path 'examples/arduino-external-libs/lib/OneWire'
Cloning into 'examples/arduino-external-libs/lib/OneWire'...
remote: Counting objects: 87, done.
remote: Total 87 (delta 0), reused 0 (delta 0), pack-reused 87
Unpacking objects: 100% (87/87), done.
remote: Counting objects: 91, done.
remote: Total 91 (delta 0), reused 0 (delta 0), pack-reused 91
Unpacking objects: 100% (91/91), done.
Checking connectivity... done.
Submodule path 'examples/arduino-external-libs/lib/OneWire': checked out '57c18c6de80c13429275f70875c7c341f1719201'
Installing package tool-scons @ >=2.3.0,<2.6.0:
atmelavr @ 0.0.0 has been successfully installed!
PackageManager: Installing tool-scons @ >=2.3.0,<2.6.0
Downloading [####################################] 100%
Unpacking [####################################] 100%
Installing package toolchain-atmelavr @ ~1.40801.0:
tool-scons @ 2.4.1 has been successfully installed!
PackageManager: Installing toolchain-atmelavr @ ~1.40801.0
Downloading [####################################] 100%
Unpacking [####################################] 100%
toolchain-atmelavr @ 1.40801.0 has been successfully installed!
The platform 'https://github.com/platformio/platform-atmelavr.git' has been successfully installed!
The rest of packages will be installed automatically depending on your build environment.
+3 -3
View File
@@ -21,7 +21,7 @@ Usage
.. code-block:: bash
platformio platform uninstall PLATFORM
platformio platform uninstall [PLATFORM...]
# uninstall specific platform version using Semantic Versioning
platformio platform uninstall PLATFORM@X.Y.Z
@@ -39,7 +39,7 @@ Examples
.. code-block:: bash
$ platformio platform uninstall atmelavr
Uninstalling platform atmelavr @ latest: [OK]
Uninstalling package tool-scons @ 2.5.0: [OK]
Uninstalling platform atmelavr @ 0.0.0: [OK]
Uninstalling package tool-scons @ 2.4.1: [OK]
Uninstalling package toolchain-atmelavr @ 1.40801.0: [OK]
The platform 'atmelavr' has been successfully uninstalled!
+32 -45
View File
@@ -21,7 +21,10 @@ Usage
.. code-block:: bash
platformio platform update
platformio platform update [OPTIONS] [PLATFORM...]
# update specific platform version using Semantic Versioning
platformio platform update PLATFORM@X.Y.Z
Description
@@ -35,64 +38,48 @@ Options
.. program:: platformio platform update
.. option::
--only-packages
-p, --only-packages
Update only platform related packages. Do not update development platform
build scripts, board configs and etc.
.. option::
-c, --only-check
Do not update, only check for new version
Examples
--------
.. code-block:: bash
$ platformio platform update
Platform atmelavr @ 0.0.0
Platform atmelavr
--------
Updating platform atmelavr @ latest:
Versions: Current=0.0.0, Latest=0.0.0 [Up-to-date]
Updating package framework-arduinoavr @ ~1.10608.0:
Versions: Current=1.10608.0, Latest=1.10608.0 [Up-to-date]
Updating package toolchain-atmelavr @ ~1.40801.0:
Versions: Current=1.40801.0, Latest=1.40801.0 [Up-to-date]
Updating package framework-simba @ ~1.500.0:
Versions: Current=1.500.0, Latest=1.500.0 [Up-to-date]
Updating package tool-scons @ >=2.3.0,<2.6.0:
Versions: Current=2.5.0, Latest=2.5.0 [Up-to-date]
Updating atmelavr @ 0.0.0: [Up-to-date]
Updating framework-arduinoavr @ 1.10608.1: [Up-to-date]
Updating tool-avrdude @ 1.60001.1: [Up-to-date]
Updating toolchain-atmelavr @ 1.40801.0: [Up-to-date]
Updating tool-scons @ 2.4.1: [Up-to-date]
Platform atmelsam @ 0.0.0
Platform espressif
--------
Updating platform atmelsam @ latest:
Versions: Current=0.0.0, Latest=0.0.0 [Up-to-date]
Updating package toolchain-gccarmnoneeabi @ >=1.40803.0,<1.40805.0:
Versions: Current=1.40804.0, Latest=1.40804.0 [Up-to-date]
Updating package framework-arduinosam @ ~1.10607.0:
Versions: Current=1.10607.0, Latest=1.10607.0 [Up-to-date]
Updating package framework-simba @ ~1.500.0:
Versions: Current=1.500.0, Latest=1.500.0 [Up-to-date]
Updating package framework-mbed @ ~1.117.0:
Versions: Current=1.117.0, Latest=1.117.0 [Up-to-date]
Updating package tool-scons @ >=2.3.0,<2.6.0:
Versions: Current=2.5.0, Latest=2.5.0 [Up-to-date]
Updating package tool-bossac @ ~1.10500.0:
Versions: Current=1.10500.0, Latest=1.10500.0 [Up-to-date]
Updating espressif @ 0.0.0: [Up-to-date]
Updating tool-scons @ 2.4.1: [Up-to-date]
Updating toolchain-xtensa @ 1.40802.0: [Up-to-date]
Updating tool-esptool @ 1.409.0: [Up-to-date]
Updating tool-mkspiffs @ 1.102.0: [Up-to-date]
Updating framework-arduinoespressif @ 1.20300.0: [Up-to-date]
Updating sdk-esp8266 @ 1.10502.0: [Up-to-date]
Platform espressif @ 0.0.0
Platform teensy
--------
Updating platform espressif @ latest:
Versions: Current=0.0.0, Latest=0.0.0 [Up-to-date]
Updating package tool-scons @ >=2.3.0,<2.6.0:
Versions: Current=2.5.0, Latest=2.5.0 [Up-to-date]
Updating package toolchain-xtensa @ ~1.40802.0:
Versions: Current=1.40802.0, Latest=1.40802.0 [Up-to-date]
Updating package framework-simba @ ~1.500.0:
Versions: Current=1.500.0, Latest=1.500.0 [Up-to-date]
Updating package tool-esptool @ ~1.408.0:
Versions: Current=1.408.0, Latest=1.408.0 [Up-to-date]
Updating package tool-mkspiffs @ ~1.102.0:
Versions: Current=1.102.0, Latest=1.102.0 [Up-to-date]
Updating package framework-arduinoespressif @ ~1.20200.0:
Versions: Current=1.20200.0, Latest=1.20200.0 [Up-to-date]
Updating package sdk-esp8266 @ ~1.10502.0:
Versions: Current=1.10502.0, Latest=1.10502.0 [Up-to-date]
Updating teensy @ 0.0.0: [Up-to-date]
Updating framework-arduinoteensy @ 1.128.0: [Up-to-date]
Updating tool-teensy @ 1.1.0: [Up-to-date]
Updating framework-mbed @ 1.121.0: [Up-to-date]
Updating tool-scons @ 2.4.1: [Up-to-date]
Updating toolchain-atmelavr @ 1.40801.0: [Up-to-date]
Updating toolchain-gccarmnoneeabi @ 1.40804.0: [Up-to-date]
...