Packaged Browser User Guide

1 | ©2021 HARMAN International Industries, Incorporated. All rights reserved.

 Version 4

Date 21.12.2020

Status Approved

Document ID HCS20-001100

Owner Sergey Kashin

Approved Tejas Moharir 24.12.2020

2 | ©2021 HARMAN International Industries, Incorporated. All rights reserved.

Table of Contents

1 Introduction ....................................................................................... 3
1.1 Purpose .............................................................................................. 3
1.2 Glossary.............................................................................................. 4

2 Installation process. ......................................................................... 4

2.1 IE-based Packaged Browser installation............................................. 4
2.1.1 IE-based silent installation. .........................................................................................4
2.2 Chromium-based Packaged Browser installation. .............................. 5
2.2.1 Chromium-based solution silent installation. ...............................................................5
2.3 IE plugin solution installation............................................................... 5

3 Features. ............................................................................................ 5
3.1 Supported command line arguments. ................................................. 5
3.1.1 Specific launching URL. ..............................................................................................5
3.2 Bookmarks. ......................................................................................... 6
3.2.1 Bookmarks in IE-based application. ............................................................................6
3.2.2 Bookmarks in Chromium-based version. ....................................................................8
3.3 Multiple tabs in Chromium-based application. .................................... 9
3.4 Chromium-based Zoom-in and Zoom-out feature. ............................ 10
3.5 IE-based application document mode (IE 7 mode by default)........... 10
3.6 Chromium-based application – printing of a Popup window. ............ 11

4 FAQ .................................................................................................. 11
4.1 Packaged Browser doesn’t work properly in Citrix environment ....... 11
4.2 IE-based Packaged Browser unable to find the Flash Player ........... 11
4.3 How to tell what version of the IE plugin is installed.......................... 11
4.4 Flash content is replaced by a Flash/Information logo ...................... 11
4.5 IE plugin installation doesn’t work ..................................................... 12

5 Change History ............................................................................... 13

1 Introduction
1.1 Purpose
This document is created to introduce users to HARMAN Packaged Browser solution for an Adobe
Flash Player End of Life case. This document describes installation process and general usage
guidelines for Packaged Browser solutions.

3 | ©2021 HARMAN International Industries, Incorporated. All rights reserved.

1.2 Glossary

Term Definition
IE-based Solution based on a standard Microsoft Web Control.
Chromium- Solution based on an Electron.js framework which is using Chromium
based engine.
IE plugin Plugin used with Microsoft Internet Explorer browser.

2 Installation process.
In order to install a package, user need to run provided <Package name>.msi file and follow
instructions provided in an installer. Default installation of a package is system wide (for all users
on a machine), so it requires administration rights.

2.1 IE-based Packaged Browser installation.

2.1.1 IE-based silent installation.

For using silent installation user need to open a command line as administrator and run installation
command:
$ msiexec /q /i <Package name>.msi
If user wants to install only for a current user than user need to execute below command:
$ msiexec /q /i <Package name>.msi MSIINSTALLPERUSER=1 ALLUSERS=2

User can also specify a TARGETDIR parameter to install in a specified directory:

$ msiexec /q /i <Package name>.msi TARGETDIR="<Installation path> "

4 | ©2021 HARMAN International Industries, Incorporated. All rights reserved.

2.2 Chromium-based Packaged Browser installation.
2.2.1 Chromium-based solution silent installation.

For using silent installation user need to open a command line as administrator and run installation
command:
$ msiexec /q /I <Package name>.msi
If user wants to install only for a current user than user need to execute below command:
$ msiexec /q /i <Package name>.msi MSIINSTALLPERUSER=1 ALLUSERS=2
User can also specify an INSTALLFOLDER parameter to install in a specified directory:
$ msiexec /q /i <Package name>.msi INSTALLFOLDER=”<Installation path>”
MSIINSTALLPERUSER=1 ALLUSERS=2

2.3 IE plugin solution installation.

Before installation of a HARMAN IE plugin the user must remove any existing Flash Player on the
machine. For Windows 7, Adobe provide an uninstaller, but for Windows 8 and later, this means
installing a Microsoft update KB4577586. For more details, please refer to a Microsoft support
topic[1].

This will ensure that Flash Player installation from HARMAN is not affected in the future by this
update.

IMPORTANT NOTE: for a testing purposes during an evaluation phase, we recommend to use
‘non-main’ machines or virtual machines, because KB4577586 cannot be easily uninstalled as
mentioned in a Microsoft support topic [1].

3 Features.
3.1 Supported command line arguments.
3.1.1 Specific launching URL.

User can specify a launch URL by using the ‘-url’ argument in a command line or in a ‘Target’ of a
shortcut. For example, if user wants to launch a https://harman.com in a Packaged Browser
application than a shortcut Target will look like this: “<Path to executable>” -url https://harman.com

5 | ©2021 HARMAN International Industries, Incorporated. All rights reserved.

See below screenshot for details.

3.2 Bookmarks.
Both IE and Chromium based versions of HARMAN Packaged Browser solution support bookmark
of pages

3.2.1 Bookmarks in IE-based application.

User can bookmark current page using a File menu item “Add to bookmarks”.

A popup dialog appears after that for the userto set a proper name for the bookmark or to modify
the URL manually.

6 | ©2021 HARMAN International Industries, Incorporated. All rights reserved.

User can open a list of bookmarked pages by clicking on a “Bookmarks…” item in a File menu of
an application.

List of bookmarked pages contains all previously bookmarked pages.

3.2.1.1 Delete bookmark in IE-based application.

If user clicks on a ‘Delete’ button for a specific bookmark on a page with bookmarks a popup
dialog would appear where user can press “OK” to delete a bookmark.

3.2.1.2 Edit bookmark in IE-based application.

User can click on ‘Edit’ button for a specific bookmark on a page with bookmarks which would
bring up a popup dialog to edit a bookmark.

7 | ©2021 HARMAN International Industries, Incorporated. All rights reserved.

3.2.2 Bookmarks in Chromium-based version.

User can bookmark current page using the Options menu item “Bookmark this page” or by pressing the
‘Ctrl+D’ shortcut on a keyboard.

A popup dialog appears after that for a user convinience to set a proper name for a bookmark or to
modify an URL manually.

User can open a list of bookmarked pages by clicking on a “Bookmarks…” item in an Option menu
of an application or by pressing a ‘Ctrl+B’ shortcut on a keyboard.

List of bookmarked pages contains all previously bookmarked pages.

8 | ©2021 HARMAN International Industries, Incorporated. All rights reserved.

3.2.2.1 Delete bookmark in Chromium-based application.

User can delete a bookmark by clicking on a ‘Delete’ button near a bookmark.

3.2.2.2 Edit bookmark in Chromium-based application.

User can click on ‘Edit’ button for a specific bookmark on a page with bookmarks which would
bring up a popup dialog to edit a bookmark.

3.3 Multiple tabs in Chromium-based application.

User can open new tab by pressing on a ‘+’ sign on a tabs bar, by clicking on a ‘New Tab’ Options
menu item or by pressing a ‘Ctrl+T’ shortcut on a keyboard.

User Can close a tab either by pressing a ‘Close Tab’ item in an Options menu or by pressing a
‘Ctrl+W’ shortcut on a keyboard or by pressing a cross icon on a tab.

9 | ©2021 HARMAN International Industries, Incorporated. All rights reserved.

3.4 Chromium-based Zoom-in and Zoom-out feature.
User can use either appropriate shortcuts or View menu items to zoom-in or zoom-out in a current
tab.

3.5 IE-based application document mode (IE 7 mode by default).

By default, IE-based application is running in an IE 7 mode. To change this setting user can
update a registry entry like shown on an image below. For more details on what this registry key
does please refer to the Microsoft documentation[2].

During evaluation phase it would be helpful if you can check what mode is used in an IE browser
using a developer tools in a browser. Open an application URL in an IE browser and then press
F12. Check ‘Emulation’ tab and a ‘Document mode’ value.

10 | ©2021 HARMAN International Industries, Incorporated. All rights reserved.

If in IE you can see that Decument mode is set to 11 than registry entry for a PackagedBroswer
application should be a decimal 11000.
This setting takes an effect on the Packaged Browser only after restart of an application.

3.6 Chromium-based application – printing of a Popup window.

User can print a Popup window by pressing a “Ctrl+P” shortcut on a keyboard.

4 FAQ
4.1 Packaged Browser doesn’t work properly in Citrix environment
If Packaged Browser doesn’t work properly in Citrix environment than disabling of Citrix hooks [3]

can resolve an issue.

4.2 IE-based Packaged Browser unable to find the Flash Player

The packaged browser solutions come with a version of the Flash Player, but the IE-based
solution also needs some registry entries to be present so that the IE engine can advertise a
particular version number of the Flash Player to the HTML/JavaScript content that it’s running. If
the user has removed the system Flash Player, then this will remove the registry entries and the
packaged browser solution may stop working. To restore the settings HARMAN have developed a
simple “Flash Player Utility” that restores the registry during installation.

Note also that the Flash Player needs to be enabled. If there are administrative policies set up on
the computer that disable the use of Flash Player, then these would prevent any IE-based
application from accessing Flash content.

4.3 How to tell what version of the IE plugin is installed

To check what version of Flash Player is available in IE, visit the Flash Player Help (adobe.com)
website and click on” Check Now”. Adobe’s versions of Flash Player go up to version 32,
HARMAN’s versions start at version 50.

4.4 Flash content is replaced by a Flash/Information logo

If a Flash/Information logo is displayed on the screen, this indicates that content is blocked by the
URL filtering (or, for evaluation licensees, the evaluation period may have expired). For evaluation
versions, a file should be generated called “flashurlfilter.log” – in the ‘temp’ folder for IE-based
solutions, and in an application-specific folder under ‘appdata’ for Chromium-based solutions.

11 | ©2021 HARMAN International Industries, Incorporated. All rights reserved.

4.5 IE plugin installation doesn’t work
Please install IE plugin as an administrator. It is required to properly register for an IE browser.

Also please make sure that Shockwave plugin is enabled in IE browser like shown on a picture
below.

References

Update for the removal of Adobe Flash Player: October 27, 2020:
[1] https://support.microsoft.com/en-us/help/4577586/update-for-removal-of-adobe-
flash-player

https://docs.microsoft.com/en-us/previous-versions/windows/internet-explorer/ie-
[2]
developer/general-info/ee330730(v=vs.85)?redirectedfrom=MSDN

[3] https://support.citrix.com/article/CTX107825

12 | ©2021 HARMAN International Industries, Incorporated. All rights reserved.

5 Change History

Version Date Change from Previous Name Status

1 07.12.2020 Document created Sergey Kashin Draft

Added silent installation

2 14.12.2020 instructions and IE document Sergey Kashin Draft
mode

3 21.12.2020 Added FAQ Sergey Kashin Draft

4 22.12.2020 Enhanced the FAQ Andrew Frost Approved

13 | ©2021 HARMAN International Industries, Incorporated. All rights reserved.