Roku Plugin for Eclipse IDE

Transcription

1 Roku Plugin for Eclipse IDE Table of Contents Sample Screen Key Features Installation Steps Usage Documentation Generator Release Notes Sample Screen Key Features Building channel applications requires several items to work together in unison: A Roku device

2 Your channel application Hosted media content (video, audio, games, etc) To make this happen, developers set up various ways to get rapid coding installed quickly on a device. Thanks to the Roku Plugin for Eclipse, within several minutes you ll have the power of a fully baked Integrated Development Environment and the customizations needed to develop, test, package, and install channels on Roku devices. Code highlight / Syntax Coloring Quickly find errors in your channel application with our built in color coding for BrightScript and Roku SceneGraph syntax. PRELIMINARY 2

3 Code completion and hints The plugin checks the reference guides for BrightScript and Roku SceneGraph, allowing for auto completion and details for parameters, methods, and nodes. Built in telnet console for BrightScript and SceneGraph All the available Roku device telnet ports are built into the plugin, allows for fast feedback on bugs, stack traces, and break points in your channel application. PRELIMINARY 3

4 Installation Steps Workspace: We encourage you to start your Roku projects in a fresh workspace. You can copy your projects back in afterwards. Perform the following steps: Download Java version 8: oracle.com/technetwork/java/javase/downloads/jre8-downloads html Download the latest version of the Eclipse Installer (currently version Neon ) for Java IDE Developers: eclipse.org/downloads/installer-inst ructions.php Add the Roku Plugin package via Eclipse > Help > Install New Software > Add... Name: Roku Plugin Location: Follow the instructions and click Next... then Finish Updating the plugin Add the Roku Plugin package using this path: Eclipse > Help > I nstall New Software > Add... Name: Roku Plugin Location: Follow the instructions and click Next. You will receive a message saying that "'BrightScript Core'" is already installed, so an update will be performed instead." Click Fini sh. Restart Eclipse. Usage PRELIMINARY 4

5 Creating a new BrightScript project Quickly have all required assets and files setup through Eclipse. In addition, reference sample channels are provided in a simple drop down for testing. The manifest, components, source, images, locale, and related directories are handled instantly. Installing and packaging channel applications Using the standard export option for projects, the Roku plugin for Eclipse enables developers to install their current channel code onto Roku devices within seconds. In addition, developers can package and key their applications for preparing the Channel Store required assets. PRELIMINARY 5

6 Documentation Generator Like many other development environments, the BrightScript Eclipse plugin can produce in-line documentation through the simple use of special tags in source code comments. An example of the kind of hover help documentation that can be generated is shown below. PRELIMINARY 6

7 . The complete specification and comment syntax for the documentation generation system, called BrightScriptDoc, can be found here. Release Notes 4/10/2012 Summary: This release concentrated on improvements to several areas of the plugin, including but not limited to: a) Any known bugs that could cause hangs or visible stacktraces in the error log b) Roku box discovery (SSDP) c) The Debug Console d) The BrightScript language parser e) User preferences f) Logging g) Manifest editing and validation The first 4 items (a-d) above were top priorities given potential impact to the usability of the plugin. The remaining items were addressed to improve the overall user experience. Both (b) and (c) are of particular note, since many of the issues reported on the Eclipse plugin thread have to do with the usability and accuracy of the Roku boxes IP address drop-down list in the Debug Console. (g) Manifest editing and validation - is also something worth checking out. The manifest file now has an associated multipage editor, which adds a form-based validating editor for the manifest, which synchronizes with the pre-existing text editor. Errors and warnings related to the manifest are a bit more clearly marked in the form-based editor page, and total known manifest property names are clearly shown. Note that eventually, the form fields will be enhanced with hover-help text derived from the SDK documentation, to further assist new developers in understanding the manifest contents. Also in the form editor are project browse buttons/dialogs for each of the icon file attributes. The dialogs show a treeview of the relevent project directories and files for icon selection. Only *.jpg and *.png PRELIMINARY 7

8 files (and the folders in the project that hold them) are shown, making it easier to ensure the icon file path names in the manifest are correct. Verification of the icon file paths (along with all the other manifest validation checks) is also performed as part of the manifest validation process, which happens both in the editor and in the project builder using code that is now common to both areas. Aside from these areas, the following enhancements are small but significant: a) Add the error log view to the BrightScript perspective Adding the error log to the BrightScript perspective should improve reporting of errors by the developer community in both speed and accuracy, since most coding (not related to design or lack of feature) bugs should show up in some way in the error log. Logging, in general, was overhauled and specific message's log-levels and log-level user preferences and defaults were adjusted to ensure the error log is not filled up with debug and trace level messages by default, making the perspective-default exposure of the error log view practical at least as it relates to the BrightScript plugin. b) Installation - add dependency update sites to plugin feature manifest By adding the dependency update sites to the feature manifest, the additional update sites get added to the user's update sites list automatically the first time the Roku update site gets added manually by the user. Note however, those added sites are not enabled by default, so the user must still manually enable them before attempting the plugin install. This change slightly speeds up and reduces errors in the initial install process, since the user no longer needs to type in the URL and label of the additional dependency update sites (DLTK and EMF) - they just need to enable them once the Roku update site has been manually added and enabled. File->Export->BrightScript->BrightScript Deployment non-response/null pointer IDE hangs on startup when Project Explorer is open and 1 or more open BrightScript projects Manifest is overwritten with plugin default when importing project files from another location Telnet window IP address drop-down is spastic Default values for code and comment folding prevent folding from working out of the box Dropdown list of rokus for the console has items truncated SSDP unicast response not seen in response to SSDP SEARCH query Language parser - Add positive and negative test cases for BrightScript language parser module Language parser - "REM" comment keyword embedded in sub or function name causes odd parser issues Language parser - incorrectly marks syntax errors when parens and brackets are adjacent Language parser - Reserved/key words that are also component method names are incorrectly flagged as syntax errors Language parser doesn't know about the "?" shortcut for print Syntax highlighter and language parser don't know about the "Library" keyword and syntax Syntax highlighting is incorrect when string "REM" is encountered anywhere in a line Code folding - Stacktrace in code folding routine Todo tasks - Nullpointer exception when activating the todo task preference page Bugs determined to be Eclipse issues that can't be worked-around in code: Enhancements: Uninstalling plugin leaves behind old <BrightScript> perspective in menu Add plugin-level framework for user selectable preferences for log level by feature group Add the error log view to the BrightScript perspective Add user selectable preferences for Discover (SSDP) - logging, time-out, etc. Add user selectable preferences for Debug Console - color, connect timeout, etc. Create a custom Roku manifest editor Installation - add dependency update sites to plugin feature manifest 9/10/2012 PRELIMINARY 8

9 A major new feature set supporting channel localization was added in this release. See the enhancements section below for a list of localization related features. Some additional notes about the new channel localization support: Many of these localization features have associated user preferences pages (Windows->Preferences->BrightScript->Localization). Each of the web translation services mentioned below also has its own separate user preferences page under the main localization page. A new context (aka popup) sub-menu for localization actions has been added and is available for any item in a BrightScript project. The localization context menu action taken will depend on the location of the file or directory selected: Any item selected inside a specific locale's folder (including the folder itself) will cause that action to happen just for that locale. Any item selected elsewhere in a BrightScript project will cause the action to happen for all locales folders already created within the project. Any locale folders that do not correspond to a currently supported locale will be ignored. Additionally, this release focused on bugfixes and enhancements for several existing areas: BUGFIXES: Language Parser Debug console Manifest Project templates should compile and run without errors Debug Console - Heap OutOfMemoryError occurs if console accumulates enough output Editor - Change of syntax color does not apply to already open editors Language Parser - "Stop" cannot be used as a method name of a component Language Parser - Allow no-argument Print statements Language Parser - Allow paren'd sub-expressions in compound (dot) expressions Language Parser - Allow reserved words as keys in associative arrays Language Parser - Empty For loops cause syntax error Language Parser - Empty If or Else blocks not allowed (when Else is present) Language Parser - Empty While loops cause syntax error Language Parser - expression processing broken when functions are mixed with operator based expressions on the same line Language Parser - Mod operator keyword is not recognized Language Parser - NULL cannot be used as variable name Language Parser - The String(n As Integer, character As String) and Stringi methods aren't recognized Language Parser - undocumented endfor and endwhile cause syntax errors Language parser and Syntax highlighter don't know about the "Library" keyword and syntax Manifest Editor - Do not flag icon and splash values as warning or errors for screensavers Manifest Editor - entries representing binary items set to true/false but should instead set to 1/0 ENHANCEMENTS: Localization - Add auto-generation of translations.xml file source tags from scanning brs files for tr calls Localization - add localization checking to the BrightScript builder Localization - Add locale selection options to "new project" wizard that will automatically build directories and files to support a localized channel for 1 or more of the currently supported locales Localization - add localization support to the manifest editor Localization - Add context menu items and new project wizard support for auto-translation of locale manifest entries: title, subtitle, and screensaver_title Localization - Add context menu options for import and export of translations to/from TMX format Localization - Add support for machine translation calls to web-based translation services (general support) Localization - Add support for machine translation calls to web-based translation service google translate Localization - Add support for machine translation calls to web-based translation service microsoft translator (aka bing translate) Localization - Add support for machine translation calls to web-based translation service mymemory.translated.net Localization - add syntax parsing and colorization support for new localization functions (tr, GetLocalizedAsset, GetPluralString) Debug Console - Add "Roku IP" label for ip selection drop-down Debug Console - Add a connect/disconnect toggle button to console toolbar Language Parser - Reparse source files for syntax checking as user types (delayed action) Manifest Editor - Add splash screen manifest settings support PRELIMINARY 9

10 Manifest Editor - Allow unknown (to parser) user-entered props in text tab to be persistent between transitions to/from overview tab Manifest Editor - display description from docs in tooltip for for each manifest var in overview form 12/17/2012 This release focused primarily on adding support for editor code folding, improved language parsing, and laying the foundation of a type system. The new Code folding features include new user preference settings and editor support for subs, function, loops, and if blocks. While not listed below, one of the first visible benefits of the type system foundation is an initial improvement in the code assist and inline documentation display features. While the code editor has focus, hitting CTRL-Space will invoke the code assist window, which now includes in the list all global functions (in addition to the previous list of language keywords) along with the documentation window containing documentation for the currently selected global function. (Note that currently code assist intentionally does not respond while in the middle of a "dot expression" - this feature will be added in the next release in order to support code assist and docs display for components, interfaces, and events). Export Wizard - Very first run of export wizard after first plugin installation does not autofill the zipfile name Export Wizard - Top level locale folder not auto-selected when exporting a project Language Parser - a variable reference standing alone by itself outside of any valid statement is not flagged as a error Language Parser - Empty For loops cause syntax error Language Parser - Empty While loops cause syntax error Localization - Update translations context menu option fails with stacktrace New Project Wizard - Error when selecting locales Enhancements: Code Folding - Add support for associative arrays and ordinary arrays Code Folding - Add support for For Loops Code Folding - Add support for if/then/else blocks Code Folding - Add support for Subs and Functions Code Folding - Add support for While Loops Editor - Make double-click only select the surrounding brightscript word, not the locale language word Export Wizard - Add persistent checkbox for zip file overwrite response Export Wizard - Remember per-project user selected dirs and files between export runs Language Parser - BrightScript language parser should recover at least at beginning of new sub or function 5/16/2013 While there where several unrelated bugfixes and new features, this release focused primarily on finishing the foundation of the type system and improving other feature groups that benefit from the expanded type system. The type system is the basis of other feature groups including autocompletion (code assist), hover docs, and various type-related parse and build-time checks. The type system had previously provided the knowledge of BrightScript global functions, but has been expanded to include Components, Interfaces, Events, and each of their associated functions and subs. The embedded docs (used in hover and autocompletion) for each of these items are a work-in-progress and will be improved over the next few releases. Autocompletion is now invoked automatically after a short delay in typing (user preference, defaults to 200ms), when the last character typed is a dot ("."). The manual invocation of autocompletion at any point is still available via CTRL-Space. The relevant type system additions (interfaces, functions/subs) now show up in the autocompletion suggestions list window, along with their docs in the associated docs window. Additionally, the suggestions list includes variables defined in the current function/sub, including associative array member variables. Hover docs - A documentation window will display when you hover the cursor over most variables function/sub calls, interface references, etc... PRELIMINARY 10

11 Note: there are several known bugs related to the new type system that sometimes prevent this from happening. The docs processing has been improved with added support for annotation tags, similar to the docs annotation systems used by other languages (e.g. javadocs, doxygen, etc). Both the built-in type system and user code (i.e. functions/subs and variables) will be able to use these tags. More details on this topic in the coming releases as specifics are finalized. The Debug console usability has been improved in a few ways. The long-standing cursor positioning bug has been fixed - the cursor should now be automatically and correctly shown at the end of the console output. The left arrow is also now prevented from moving into the prompt and output areas, although you may still manually place the cursor there for cut/paste purposes. The Debug console now includes simple command history support. The up and down arrows move thru the command history stack. User-preferences for the command history size (defaults to 1000) and whether or not to persist across sessions (defaults to false) have been added. Task tags are now working as expected. Code folding - "initially folding" options are ignored Autocompletion - does not recognize interface names in already typed dot expression Autocompletion - fails when item to be completed is the last line (or part of last statement) of a function/sub Autocompletion - suggestions list does not include interface names Debug Console - Cursor incorrectly is always at the beginning of the line Language Parser - GetGlobalAA global function missing from parser grammar Language Parser - Some global function calls cause editor open failure with nullpointerexception Selection Engine - Highlighting a function reference and then selecting Show in-> Outline View does not do anything Selection Engine - Open Declaration does not do anything TODO tasks don't show up in the Task view Type system - Erroneous type func/sub call error - says func/sub must be disambiguated by interface name, when the name matches but not the signatures do not Type System - Non-Windows platforms get stacktrace (NullPointerException) when attempting to open BrightScript source editor Enhancements: Debug Console - Add support for command history recall Docs system - Add support for docs annotation tags to improve help display Editor - Add line number display to left-hand margin Export Wizard - Improve error handling and error message for failed connections and provide exposed user preferences for each type of connection Language Parser - Add context-specific, fine-grained error recovery to parser Language parser - Add syntax checking, code completion, and help support for all pre-defined components Language parser - add type inference system to support type-related parse and build-time error checking and warning generation New Resource Wizards - Add a "New BrightScript File" wizard and menu entry Type System - Add a user preference to determine whether or not to perform type related warning/error checks 6/27/2013 This release addresses various bug fixes in the plugin. Type System - use of ifassociativearray and ifenum methods in any return expression beginning with m. cause all.brs source editors in a project to fail Type System - partial addition to support tracking specific event types expected on specific romessageport instances Export to BrightScript errors before IP field entry is complete Docs system - hypertext links embedded in the documentation html will not respond to clicks Docs system - Add support for docs window toolbar buttons: forward, backward, open declaration Docs system - Add support for field comments on same line Search - References searching doesn't return any results PRELIMINARY 11

12 9/30/2013 This release is a large update containing bugfixes and enhancements for the communications sub-system, type sub-system, language parser, and export wizard. Support for the new developer mode username/password authentication is in place, but is not used unless a given Roku box requires it ( i.e. firmware 5.2 or later ). It is important to note that the plugin now requires Eclipse to be running under Java 1.7 or higher. If Eclipse's Java version is lower than 1.7, the plugin will be disabled. Non-compliance with the Java version requirement does not prevent plugin installation or Eclipse startup, but will result in no BrightScript plugin features being visible, including the BrightScript perspective. If you require an older version of Java as your machine default, you may still point any Eclipse instance to a different Java installation, by using the -vm argument in the eclipse.ini file (see Eclipse's help for details). Enhancements: Comms Firmware Requires Username and Password for all to-box HTTP communications Comms - Adjustments to socket timeouts and enhanced language for adjusting the values Export wizard - Add user option for per-project auto-increment version number in manifest for each run Export Wizard - Automatically refresh project explorer after zipfile creation and package file creation Export Wizard - Use ECP to send "Home" keypress prior to start of sideload/package operation to prevent unnecessary timeouts and related errors Type system - Change single-valued type system to multi-valued type system with distinct single declared and multiple possibles Plugin dependencies - Change Java minimum requirement to 1.7 to avoid Java memory management bug Export Wizard - IP addresses typed in manually (or an empty address) are not checked for validity before attempting HTTP operations Export Wizard - Nullpointer exception and partial localization checks failure if 1 or more locale subfolders does not exactly name match one of the supported locales Export Wizard - Manually entered Roku Box IP addresses aren't persistent in either Export wizard or Debug console Export Wizard - Unexpected error while retrieving package file Language Parser - Add Function as a valid explicit parameter and return type Language Parser - Anonymous Functions with empty bodies cause NullpointerException during parsing, causing source files to not open in BrightScript editor Type System - Several type-related checks ignore user preference "perform type checks" Type System - AA var returned from func/sub calls don't contain their members Type System - Known callers check returns a false positive when all callers are associative arrays Type System - Return type check incorrectly sets return type to void if type of return expression is unknown Type System - Use of ifassociativearray and ifenum methods in any return expression beginning with m. cause all.brs source editors in a project to fail 11/12/2013 This is a minor release containing bug fixes. The build number is Note It is important to note that the plugin now requires Eclipse to be running under Java 1.7 or higher. If Eclipse's Java version is lower than 1.7, the plugin will be disabled. Non-compliance with the Java version requirement does not prevent plugin installation or Eclipse startup, but will result in no BrightScript plugin features being visible, including the BrightScript perspective. If you require an older version of Java as your machine default, you may still point any Eclipse instance to a different Java installation, by using the -vm argument in the eclipse.ini file (see Eclipse's help for details). Enhancements: - Export Wizard - Added option to automatically open and connect a debug console upon successful install - Code Folding - Added support for anonymous functions PRELIMINARY 12

13 - Bug fixes to correct exceptions and errors in SSDP discovery routines - Export Wizard - Corrects issue of zip and pkg files saved in "out" dir first time, but root dir all subsequent times - Export Wizard - Corrects issue where current package field is not populated even if there is a current package 1/7/2014 This is a minor release containing bug fixes. The build number is Minor bug fixes for BrightScript Doc parser 6/27/2014 This is a large release containing a number of enhancements. The build number is Enhancements: The Deployment preferences screen now let's you select file extensions of files to include in the channel deployment by default. Added hyperlinking for error code/text in debugger output to a browser window for expanded help text about error. Some updates to the documentation generator. Added the ability for developers to create their own Eclipse code templates. Go to Preferences Editor Templates and create a new code template. These templates can then be inserted into your code by typing the template name followed by the autocompletion keystroke ctrl-space. Sync source code editor window with debug console output via custom hyper-links for debugger references to source files/line numbers. Set initial default value of auto-increment manifest version to "Build". Added support for pkg:/ prefixed files with autocompletion. Added toolbar item and shortcut keystroke for running previous export without dialog. On Windows & Linux: CTRL-ALT-E On OSX: COMMAND-OPTION-E. Added a user pref for timeout value for manually entered IP addresses to the Preferences Discovery wizard screen. Added support for infinite timeout on manually entered IP addresses (by setting the IP address timeout described above to 0)and allow for manual removal of IPs from list. Changed developer password field from regular textbox to password style. PRELIMINARY 13