Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

test_app: Update README.md to explain how to install pre-built bundles #55

Merged
merged 1 commit into from
Dec 5, 2024
Merged

test_app: Update README.md to explain how to install pre-built bundles #55

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
65 changes: 24 additions & 41 deletions test_app/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -9,33 +9,34 @@ Chrome Dev.
### Getting a copy of Chrome Dev

On your platform of choice, download
[Chrome Dev](https://www.google.com/chrome/dev/) and set an alias for the
executable path. Per-platform instructions:
[Chrome Dev](https://www.google.com/chrome/dev/).

#### MacOS

```sh
CHROME="/Applications/Google Chrome Dev.app/Contents/MacOS/Google Chrome Dev"
```
## Run Chrome with the right flags

#### Windows
Some of the features you'll be trying are still under development and only
available with a particular configuration setting. Configure Chrome to prepare
for running the demo 'test_app' application.

```sh
CHROME="C:\Program Files (x86)\Google\Chrome Dev\Application\chrome.exe"
```
Navigate to chrome://flags, and enable the following Experiments:
1. enable-isolated-web-apps
1. enable-isolated-web-app-dev-mode
1. enable-controlled-frame

#### Linux
## Install the demo application
### Pre-built

```sh
CHROME="/opt/google/chrome-unstable/chrome"
Navigate to chrome://web-app-internals, and enter the following URL into the
"Install IWA from Update Manifest" field:
```
https://github.com/WICG/controlled-frame/releases/latest/download/controlled-frame-test-app-update.json
```

## Run Chrome with the right flags

Some of the features you'll be trying are still under development and only
available with a particular configuration setting. Configure Chrome to prepare
for running the demo 'test_app' application.
Alternatively, download the latest release
[here](https://github.com/WICG/controlled-frame/releases/latest/download/controlled-frame-test-app.swbn).
Navigate to chrome://web-app-internals, click the button next to the "Install IWA from Signed Web Bundle"
label, and select the downloaded swbn file.

### From source
1. Install JS dependencies

```sh
Expand All @@ -48,31 +49,13 @@ pnpm install
pnpm run dev
```

3. Execute Chrome with the following flags once.

```sh
$CHROME --enable-features=IsolatedWebApps,IsolatedWebAppDevMode,ControlledFrame
3. Navigate to chrome://web-app-internals, and enter the following URL into the
"Install IWA via Dev Mode Proxy" field:
```

**Optional:** Use the `--user-data-dir` flag to install the IWA in a separate
Chrome profile. For example:

```sh
$CHROME --user-data-dir=$HOME/tmp \
--enable-features=IsolatedWebApps,IsolatedWebAppDevMode,ControlledFrame
http://localhost:5193
```

The user data directory can be cleared to start Chrome in a fresh profile.

4. Wait for Chrome to launch

## Install the demo application

Perform the steps below to run the demo app.

1. Navigate to chrome://web-app-internals, install the app at http://localhost:5193

2. Launch the Controlled Frame test app
4. Launch the Controlled Frame test app

In Chrome/Chromium, you should see the demo app in chrome://apps. Click on it
to launch the IWA.
Loading