You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
<spanclass="notes">**Note:** This feature does not work in applications that contain a ```main``` function that is outside of a `TESTS` directory.</span>
691
692
693
+
## mbed CLI configuration
694
+
695
+
Many options in *mbed CLI* can be streamlined with global and local configuration.
696
+
697
+
The *mbed CLI* configuration syntax is:
698
+
```
699
+
mbed config [--global] <var> [value] [--unset]
700
+
```
701
+
702
+
The **global** configuration (via `--global` option) defines the default behavior of *mbed CLI* across programs unless overridden by *local* settings.
703
+
704
+
The **local** configuration (without `--global`) is per mbed program and allows overriding of global or default *mbed CLI* settings within the scope of a program or library and its dependencies.
705
+
706
+
If **no value** is specified then *mbed CLI* will print the currently set value for this settings from either local or global scope.
707
+
708
+
The `--unset` option allows removing of a setting.
709
+
710
+
Here is a list of currently implemented configuration settings:
711
+
*`target` - Define default target for `compile`, `test` and `export`, and is an alias to `mbed target`. Default: none.
712
+
*`toolchain` - Defines default toolchain for `compile` and `test` can be set through `mbed toolchain`. Default: none.
713
+
*`ARM_PATH`, `GCC_ARM_PATH`, `IAR_PATH` - defines default path to ARM Compiler, GCC ARM and IAR Workbench toolchains. Default: none.
714
+
*`protocol` - Defines the default protocol used for importing/cloning of programs and libraries. Possible values are `https`, `http` and `ssh`. Default: `https`.
715
+
*`depth` - Defines *clone* depth for importing/cloning and applies only to *Git* repositories. Note that while this option may improve cloning speed, it may also prevent you from correctly checking out a dependency tree when the reference revision hash older than the clone depth. Google `shallow clone` if you'd like to know more about using shallow clones. Default: none.
716
+
*`cache` (EXPERIMENTAL) - Defines local path that will be used to store minimalistic copies of the imported/cloned repositories and attempt to use them to minimize traffic and speed up future importing. Note that this is an experimental feature and should be used for stable and production-ready repositories only. Default: none (disabled).
717
+
692
718
## Known limitations
693
719
694
720
<spanclass="warnings">**Warning**: At this point, *mbed CLI* is alpha quality and very much in development. Breakages are fully expected. Please open issues on this repository for any problems that you find with *mbed CLI*.</span>
0 commit comments