No release in over a year
Fastlane plugin for Roku app utility.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies
 Project Readme

Fastlane roku_app_util plugin

fastlane Plugin Badge Gem Version

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.