Fastlane roku_app_util
plugin
Getting Started
This project is a fastlane plugin. To get started with fastlane-plugin-roku_app_util
, add it to your project by running:
fastlane add_plugin roku_app_util
If the command prompts you with an option, select Option 3: RubyGems.org.
About roku_app_util
Fastlane plugin for Roku app automation. All actions require a Roku dev server on the same network as the machine running the following Fastlane actions.
Available actions
-
roku_dev_server_check
: Checks Roku dev server -
roku_dev_server_rekey
: Rekeys the dev server to the provided signed package -
roku_app_install
: Installs the app as a dev channel on a Roku target device -
roku_app_uninstall
: Uninstalls any apps/dev channels on a Roku target device -
roku_app_package
: Creates Roku package from application sources
Action: roku_dev_server_check
Description: Checks Roku dev server
Parameters:
Key | Environment Variable Equivalent | Description | Required? |
---|---|---|---|
dev_target |
ROKUAPPUTIL_DEV_TARGET |
The IP of the Roku dev target | YES |
Action: roku_dev_server_rekey
Description: Rekeys the dev server to the provided signed package
Parameters:
Key | Environment Variable Equivalent | Description | Required? |
---|---|---|---|
dev_target |
ROKUAPPUTIL_DEV_TARGET |
The IP of the Roku dev target | YES |
dev_user |
ROKUAPPUTIL_DEV_USER |
Roku development username | NO - Default value: rokudev
|
dev_pass |
ROKUAPPUTIL_DEV_PASS |
Roku development password | YES |
sign_key |
ROKUAPPUTIL_SIGN_KEY |
Roku signing key | YES |
app_path |
ROKUAPPUTIL_APP_PATH |
Roku signed application file path | YES |
Action: roku_app_install
Description: Installs the app as a dev channel on a Roku target device
Parameters:
Key | Environment Variable Equivalent | Description | Required? |
---|---|---|---|
dev_target |
ROKUAPPUTIL_DEV_TARGET |
The IP of the Roku dev target | YES |
dev_user |
ROKUAPPUTIL_DEV_USER |
Roku development username | NO - Default value: rokudev
|
dev_pass |
ROKUAPPUTIL_DEV_PASS |
Roku development password | YES |
zip_path |
ROKUAPPUTIL_ZIP_PATH |
Roku application ZIP file path | YES |
Action: roku_app_uninstall
Description: Uninstalls any apps/dev channels on a Roku target device
Parameters:
Key | Environment Variable Equivalent | Description | Required? |
---|---|---|---|
dev_target |
ROKUAPPUTIL_DEV_TARGET |
The IP of the Roku dev target | YES |
dev_user |
ROKUAPPUTIL_DEV_USER |
Roku development username | NO - Default value: rokudev
|
dev_pass |
ROKUAPPUTIL_DEV_PASS |
Roku development password | YES |
Action: roku_app_package
Description: Creates Roku package from application sources
Parameters:
Key | Environment Variable Equivalent | Description | Required? |
---|---|---|---|
dev_target |
ROKUAPPUTIL_DEV_TARGET |
The IP of the Roku dev target | YES |
dev_user |
ROKUAPPUTIL_DEV_USER |
Roku development username | NO - Default value: rokudev
|
dev_pass |
ROKUAPPUTIL_DEV_PASS |
Roku development password | YES |
zip_path |
ROKUAPPUTIL_ZIP_PATH |
Roku application ZIP file path | YES |
sign_key |
ROKUAPPUTIL_SIGN_KEY |
Roku signing key | YES |
app_name |
ROKUAPPUTIL_APP_NAME |
Roku application name | YES |
app_version |
ROKUAPPUTIL_APP_VERSION |
Roku application version | YES |
pkg_output_path |
ROKUAPPUTIL_PKG_OUTPUT_PATH |
Roku application PKG path | NO - Default value: ./
|
Example
Check out the example Fastfile
to see how to use this plugin. Try it by cloning the repo, running fastlane install_plugins
and bundle exec fastlane test
.
Note to author: Please set up a sample project to make it easy for users to explore what your plugin does. Provide everything that is necessary to try out the plugin in this project (including a sample Xcode/Android project if necessary)
Run tests for this plugin
To run both the tests, and code style validation, run
bundle exec rake
To automatically fix many of the styling issues, use
bundle exec rubocop -a
Issues and Feedback
For any other issues and feedback about this plugin, please submit it to this repository.
Troubleshooting
If you have trouble using plugins, check out the Plugins Troubleshooting guide.
Using fastlane Plugins
For more information about how the fastlane
plugin system works, check out the Plugins documentation.
About fastlane
fastlane is the easiest way to automate beta deployments and releases for your iOS and Android apps. To learn more, check out fastlane.tools.
License
This repository is released under the MIT license. View the local license file.