apps

Documentation

Overview

Package apps provides general ChromeOS app utilities.

Index

• Variables
• func Close(ctx context.Context, tconn *chrome.TestConn, appID string) error
• func InstallPWAForURL(ctx context.Context, cr *chrome.Chrome, pwaURL string, timeout time.Duration) (string, error)
• func Launch(ctx context.Context, tconn *chrome.TestConn, appID string) error
• func LaunchChromeByShortcut(tconn *chrome.TestConn, incognitoMode bool) action.Action
• func LaunchOSSettings(ctx context.Context, cr *chrome.Chrome, url string) (*chrome.Conn, error)
• func LaunchSystemWebApp(ctx context.Context, tconn *chrome.TestConn, appName, url string) error
• func ListSystemWebApps(ctx context.Context, tconn *chrome.TestConn) ([]*ash.ChromeApp, error)
• func ListSystemWebAppsInternalNames(ctx context.Context, tconn *chrome.TestConn) ([]string, error)
• type App
  • func ChromeOrChromium(ctx context.Context, tconn *chrome.TestConn) (App, error)
  • func PrimaryBrowser(ctx context.Context, tconn *chrome.TestConn) (App, error)

Variables

var AndroidSettings = App{
	ID:   "mconboelelhjpkbdhhiijkgcimoangdj",
	Name: "Android Settings",
}

AndroidSettings has details about ARC settings app.

var Borealis = App{
	ID:   "dkecggknbdokeipkgnhifhiokailichf",
	Name: "Borealis",
}

Borealis App represents the installer/launcher for the borealis.

var Calculator = App{
	ID:   "oabkinaljpjeilageghcdlnekhphhphl",
	Name: "Calculator",
}

Calculator has details about the Calculator app.

var Camera = App{
	ID:   "njfbnohfdkmbmnjapinfcopialeghnmh",
	Name: "Camera",
}

Camera has details about the Camera app.

var Canvas = App{
	ID:   "ieailfmhaghpphfffooibmlghaeopach",
	Name: "Chrome Canvas",
}

Canvas has details about the Chrome Canvas app.

var Chat = App{
	ID:   "mhihbbhgcjldimhaopinoigbbglkihll",
	Name: "Google Chat",
}

Chat App has details about the Google Chat app.

var Chrome = App{
	ID:   "mgndgikekgjfcpckkfioiadnlibdjbkf",
	Name: "Chrome",
}

Chrome has details about the Chrome app.

var Chromium = App{
	ID:   "mgndgikekgjfcpckkfioiadnlibdjbkf",
	Name: "Chromium",
}

Chromium has details about the Chromium app. It replaces Chrome on amd64-generic builds.

var Citrix = App{
	ID:   "haiffjcadagjlijoggckpgfnoeiflnem",
	Name: "Citrix Workspace",
}

Citrix has details about Citrix Workspace app.

var Clock = App{
	ID:   "ddmmnabaeomoacfpfjgghfpocfolhjlg",
	Name: "Clock",
}

Clock has details about the Clock app.

var ConnectivityDiagnostics = App{
	ID:   "pinjbkpghjkgmlmfidajjdjocdpegjkg",
	Name: "Connectivity Diagnostics",
}

ConnectivityDiagnostics has details about the Chrome Connectivity Diagnostics app.

var Contacts = App{
	ID:   "kipfkokfekalckplgaikemhghlbkgpfl",
	Name: "Contacts",
}

Contacts has details about the Contacts app.

var Cursive = App{
	ID:   "apignacaigpffemhdbhmnajajaccbckh",
	Name: "Cursive",
}

Cursive has details about the Cursive app.

var Diagnostics = App{
	ID:   "keejpcfcpecjhmepmpcfgjemkmlicpam",
	Name: "Diagnostics",
}

Diagnostics has details about Diagnostics SWA.

var Docs = App{
	ID:   "aohghmighlieiainnegkcijnfilokake",
	Name: "Docs",
}

Docs has details about the Google Docs app.

var Drive = App{
	ID:   "apdfllckaahabafndbhieahigkjlhalf",
	Name: "Google Drive",
}

Drive has details about the Google Drive app.

var Duo = App{
	ID:   "djkcbcmkefiiphjkonbeknmcgiheajce",
	Name: "Duo",
}

Duo has details about the Duo app.

var FamilyLink = App{
	ID:   "mljomdcpdfpfdplmgghfeoofmbbianlf",
	Name: "Family Link",
}

FamilyLink has details about the Family Link app.

var Files = App{
	ID:   "hhaomjibdihmijegdhdafkllkbggdgoj",
	Name: "Files",
}

Files has details about the Files Chrome app.

var FilesSWA = App{
	ID:   "fkiggjmkendpmbegkagpmagjepfkpmeb",
	Name: "Files",
}

FilesSWA has details about the Files System Web App.

var FirmwareUpdate = App{
	ID:   "nedcdcceagjbkiaecmdbpafcmlhkiifa",
	Name: "Firmware Updates",
}

FirmwareUpdate has details about the FirmwareUpdate SWA.

var Gallery = App{
	ID:   "jhdjimmaggjajfjphpljagpgkidjilnj",
	Name: "Gallery",
}

Gallery (aka Backlight) has details about the Gallery app.

var Gmail = App{
	ID:   "hhkfkjpmacfncmbapfohfocpjpdnobjg",
	Name: "Gmail",
}

Gmail has details about the gmail app.

var Help = App{
	ID:   "nbljnnecbjbmifnoehiemkgefbnpoeak",
	Name: "Explore",
}

Help (aka Explore) has details about the Help app.

var Lacros = App{
	ID:   "jaimifaeiicidiikhmjedcgdimealfbh",
	Name: "Lacros",
}

Lacros has details about Lacros browser app.

var Maps = App{
	ID:   "gmhipfhgnoelkiiofcnimehjnpaejiel",
	Name: "Maps",
}

Maps has details about Arc Maps app.

var Parallels = App{
	ID:   "lgjpclljbbmphhnalkeplcmnjpfmmaek",
	Name: "Parallels Desktop",
}

Parallels has details about the Parallels app.

var Photos = App{
	ID:   "fdbkkojdbojonckghlanfaopfakedeca",
	Name: "Photos",
}

Photos has details about the Photos app.

var PlayBooks = App{
	ID:   "cafegjnmmjpfibnlddppihpnkbkgicbg",
	Name: "Play Books",
}

PlayBooks has details about the Play Books app.

var PlayGames = App{
	ID:   "nplnnjkbeijcggmpdcecpabgbjgeiedc",
	Name: "Play Games",
}

PlayGames has details about the Play Games app.

var PlayMovies = App{
	ID:   "dbbihmicnlldbflflckpafphlekmjfnm",
	Name: "Play Movies & TV",
}

PlayMovies has details about the Play Movies & TV app.

var PlayStore = App{
	ID:   "cnbgggchhmkkdmeppjobngjoejnihlei",
	Name: "Play Store",
}

PlayStore has details about the Play Store app.

var PrintManagement = App{
	ID:   "fglkccnmnaankjodgccmiodmlkpaiodc",
	Name: "Print jobs",
}

PrintManagement has details about the Print Management app.

var Scan = App{
	ID:   "cdkahakpgkdaoffdmfgnhgomkelkocfo",
	Name: "Scan",
}

Scan has details about the Scan SWA.

var Settings = App{
	ID:   "odknhmnlageboeamepcngndbggdpaobj",
	Name: "Settings",
}

Settings has details about the Settings app.

var ShimlessRMA = App{
	ID:   "ijolhdommgkkhpenofmpkkhlepahelcm",
	Name: "Shimless RMA",
}

ShimlessRMA has details about the Shimless RMA app.

var TaskManager = App{
	ID:   "ijaigheoohcacdnplfbdimmcfldnnhdi",
	Name: "Task Manager",
}

TaskManager has details about the Task Manager app.

var TelemetryExtension = App{
	ID:   "lhoocnmbcmmbjgdeaallonfplogkcneb",
	Name: "Telemetry Extension",
}

TelemetryExtension has details about the TelemetryExtension app.

var Terminal = App{
	ID:   "fhicihalidkgcimdmhpohldehjmcabcf",
	Name: "Terminal",
}

Terminal has details about the Crostini Terminal app.

var Translate = App{
	ID:   "pacmnfddiadhhfmngijgjdbnodjkmojl",
	Name: "Translate",
}

Translate has details about the Translate app.

var VMWare = App{
	ID:   "ppkfnjlimknmjoaemnpidmdlfchhehel",
	Name: "VMware Horizon",
}

VMWare has details about VMware Horizon app.

var WallpaperPicker = App{
	ID:   "obklkkbkpaoaejdabbfldmcfplpdgolj",
	Name: "Wallpaper Picker",
}

WallpaperPicker has details about the Wallpaper Picker app.

var WebStore = App{
	ID:   "ahfgeienlihckogmohjhadlkjgocpleb",
	Name: "Web Store",
}

WebStore has details about the WebStore app.

var YouTubeCWS = App{
	ID:   "blpcfgokakmgnkcojhhkbfbldkacnbeo",
	Name: "YouTube",
}

YouTubeCWS has details about the YouTube app from Chrome Web Store.

var Youtube = App{
	ID:   "aniolghapcdkoolpkffememnhpphmjkl",
	Name: "Youtube",
}

Youtube has details about the Youtube app.

Functions

func Close

func Close(ctx context.Context, tconn *chrome.TestConn, appID string) error

Close closes an app specified by appID.

func InstallPWAForURL

func InstallPWAForURL(ctx context.Context, cr *chrome.Chrome, pwaURL string, timeout time.Duration) (string, error)

InstallPWAForURL navigates to a PWA, attempts to install and returns the installed app ID.

func Launch

func Launch(ctx context.Context, tconn *chrome.TestConn, appID string) error

Launch launches an app specified by appID.

func LaunchChromeByShortcut

func LaunchChromeByShortcut(tconn *chrome.TestConn, incognitoMode bool) action.Action

LaunchChromeByShortcut launches a new Chrome window in either normal user mode by shortcut `Ctl+N` or incognito mode by shortcut `Ctl+Shift+N`.

func LaunchOSSettings

func LaunchOSSettings(ctx context.Context, cr *chrome.Chrome, url string) (*chrome.Conn, error)

LaunchOSSettings launches the OS Settings app to its subpage URL, and returns a connection to it. When this method returns, OS Settings page has finished loading.

This method is necessary because OS Settings now uses System Web App link capturing, which doesn't work with DevTools protocol CreateTarget.

Note, `url` needs to exactly match the page OS Settings ends up navigating to. For example, chrome://os-settings/.

func LaunchSystemWebApp

func LaunchSystemWebApp(ctx context.Context, tconn *chrome.TestConn, appName, url string) error

LaunchSystemWebApp launches a system web app specifide by its name and URL.

func ListSystemWebApps

func ListSystemWebApps(ctx context.Context, tconn *chrome.TestConn) ([]*ash.ChromeApp, error)

ListSystemWebApps retrieves a list of installed apps and filters down the system web apps.

func ListSystemWebAppsInternalNames

func ListSystemWebAppsInternalNames(ctx context.Context, tconn *chrome.TestConn) ([]string, error)

ListSystemWebAppsInternalNames returns a string[] that contains system app's internal names. It queries System Web App Manager via Test API.

Types

type App

type App struct {
	// ID is the Chrome extension ID of the app.
	ID string
	// Name is the name of the app.
	Name string
}

App is used to represent a ChromeOS app.

func ChromeOrChromium

func ChromeOrChromium(ctx context.Context, tconn *chrome.TestConn) (App, error)

ChromeOrChromium returns the correct browser for the current build. Chromium is returned on non branded builds (e.g amd64-generic).

func PrimaryBrowser

func PrimaryBrowser(ctx context.Context, tconn *chrome.TestConn) (App, error)

PrimaryBrowser returns the primary browser for the current system configuration. In LacrosPrimary and LacrosOnly configurations, this is 'Lacros'. Otherwise it is 'Chrome' or 'Chromium' depending on branding. The given TestConn must be a connection to Ash.