Skip to content
This repository has been archived by the owner on Feb 11, 2021. It is now read-only.

Latest commit

 

History

History
73 lines (48 loc) · 2.45 KB

README.cpc.md

File metadata and controls

73 lines (48 loc) · 2.45 KB
Raw

Ubuntu WSL

This project is hosted here: https://github.com/CanonicalLtd/WSL-DistroLauncher

Forked from: https://github.com/CanonicalLtd/WSL-DistroLauncher

Changes

The launcher has been branded with our name, text, logos etc. In the future we should also use our font, and our color scheme.

To regenerate branding please run make from the top level directory.

How to build

Run: ./create-wsl-app-install.tar.gz.sh .

Using Developer Console for VS (or cmd.exe) change into top level directory and execute build.bat script. This should create Ubuntu.appx

  • If a self-signed certificate for sideloading doen't exist, a new one will be created

  • Install Ubuntu.cer by double clicking it and installing it for the Local Machine, as third-party root certificate

Testing

  • Launch Ubuntu.appx which should bring up the store app installation screen

    • BUG sometimes the logo is not visible in the top right corner of that window
    • Relaunching Ubuntu.appx makes it visible, hopefully this is sideloading bug only

  • Install the app

  • From start menu, one can find the app under U-Ubuntu, pin to taskbar, pin to start, resize once to pinned to start into all available sizes.

  • Launching the app should launch the first time registration of the tarball for the user. It currently will ask for username and password, and at the end will drop user into the bash shell.

Uninstall / Clean up

  • Execute ubuntu clean or use wslconfig /u ubuntu

  • Uninstall the app from the start menu

Sharing / Publishing

To share the built app one needs to share the .appx and the .cer.

build.bat should really be updated with version number bumped.

Using appx on Ubuntu (fb-util-for-appx) results in packages that Windows rejects installing =( Therefore the code at https://code.launchpad.net/~cloudware/cloudware/+git/cpc-wsl is a bit pointless at the moment.

Versioning

The build process and the Windows Store impose some restrictions on the version number. It must end with a .0 component and leading zeros must be stripped from individual components. Our versioning scheme which is compatible with these restrictions is RRRR.YYYY.MMDD.0, where:

  • RRRR is the release version with the . separator removed. For example, 16.04 (xenial) is 1604.
  • YYYY is the year of the serial.
  • MMDD is the month and day of the serial (with any leading zeros removed).
  • As we only expect to publish a single appx per day, any sub-serial version numbers are dropped.