In this article
The ArborXR CLI is available as a binary file to run in the command line on all major operating systems. It is designed to be integrated with a CI/CD tool such as Jenkins or GitLab CI.
These URLs can be integrated with your pipelines to automatically grab the latest version of the CLI Binary.
Currently we only offer passing through a username and password for an ArborXR account.
This can either be done by passing the login details as launch options (
password) or by setting the environment variables
ARBORXR_PASSWORD. Please note that the authentication options need to come after the first root command, but before any further nested command, e.g.:
./arborxr-cli content --username [email protected] --password password123 list<br>
In the future we will be evaluating adding support for other methods of authentication such as generating a local keyfile or passing an API key
To upload a build with the CLI, you first need to identify the ID of either the organization content or the content channel.
Organization content ID: This is the string of characters at the end of the URL while you are in the content's overview page in the ArborXR web portal.
Content channel ID: In an interactive shell, run the
content channel listcommand then pick any of your organizations' contents. The ID of all available channels for that content will be printed.
The path argument can either point to a directory or a file. If necessary, the CLI will automatically create an archive before continuing with the upload.
The command will await the ArborXR platform’s build processing to finish and prints the details. The exit code can be used to identify whether the processing finished with a failure state or whether it succeeded. All exit codes are documented by the command
To learn about the options this commands supports, please run
content channel upload --help.
View Latest Build Version
💡 NOTE: The
To view the version details of the latest build:
content channel listand provide the content ID to gather the content channel ID.
content channel build listand provide the above channel ID to collect the IDs of all builds.
content channel build viewand provide the latest build ID gathered above.
This will print the details of the latest build, including the version code.
NOTE: Alternatively, you can simply run the
content channel build view command without providing a build ID. By doing so, the CLI will start an interactive mode in which it asks you to pick the content, its channel and then one of its builds. For more information on this, please run the
explain ids command.
The CLI comes with the ability to query various details of your ArborXR organization. Additionally it can update itself and will tell you when the version you’re running is out of date. Just run the executable with no arguments to learn about the various commands.
⚠️ IMPORTANT: Currently we are only able to support the credentials of users that have access to exactly one ArborXR organization. Any user that has access to multiple organizations will have a random organization picked, which could cause various commands to fail.