GHA to create a release

.github/workflows/create_release.yml

@@ -0,0 +1,56 @@
+name: Create GitHub Release for Extension Package
+
+on:
+    workflow_dispatch:
+
+jobs:
+    release:
+        runs-on: ubuntu-latest
+
+        steps:
+            - name: Checkout code
+              uses: actions/checkout@v3
+
+            - name: Install Node.js
+              uses: actions/setup-node@v3
+              with:
+                  node-version: '16.x'
+
+            - name: Install dependencies
+              run: npm install
+
+            - name: Build VSIX Package
+              run: npx vsce package
+
+            - name: Create release
+              id: create_release
+              uses: actions/github-script@v6
+              with:
+                  script: |
+                      const fs = require('fs');
+                      const packageVersion = require('./package.json').version;
+                      const response = await github.rest.repos.createRelease({
+                        owner: context.repo.owner,
+                        repo: context.repo.repo,
+                        tag_name: `v${packageVersion}`,
+                        name: `Release ${packageVersion}`,
+                        body: `Generating release for version ${packageVersion}`
+                      });
+                      return response.data.id;
+
+            - name: Attach VSIX package to release
+              uses: actions/github-script@v6
+              with:
+                  script: |
+                      const fs = require('fs');
+                      const packageJson = require('./package.json');
+                      const packageName = packageJson.name;
+                      const packageVersion = packageJson.version;
+                      const vsixFilename = `${packageName}-${packageVersion}.vsix`;
+                      await github.rest.repos.uploadReleaseAsset({
+                        owner: context.repo.owner,
+                        repo: context.repo.repo,
+                        release_id: ${{ steps.create_release.outputs.result }},
+                        name: vsixFilename,
+                        data: fs.readFileSync(vsixFilename)
+                      });

RELEASE.md

@@ -1,25 +1,25 @@
-Instructions to package this as an extension (*.vsix) file:
+# Releasing the Mobile Extension
 
-1. Install vsce
+## Validating the release package locally, before publishing
 
-```
-npm install -g @vscode/vsce
-```
+Before publishing the extension, you'll want to test the "built" extension package locally, as the bundling and packaging workflow creates an extension whose code is structured quite differently from what you work with in a local development environment, and as such unforeseen issues could show up that otherwise wouldn't with local development.
 
-2. Install dependencies
+The following instructions will create the extension package (`salesforcedx-vscode-mobile-<version>.vsix`) locally:
 
-NOTE: The packaging steps prunes the node_modules tree, so running `npm install` will reinstall dev dependencies.
+1.  Install the repository package
 
-```
-npm install
-```
+        npm install
 
-3. Create package
+2.  Create the VSIX package
 
-```
-vsce package
-```
+        npx vsce package
 
-4. Manually install the generated .vsix file and smoke test.
+    **NOTE:** The packaging workflow prunes the dev dependencies out of the `node_modules/` tree, so you'll need to re-run `npm install` to reinstall dev dependencies and continue development work.
 
-TODO: Eventually we can sign and publish it directly to marketplace.
+3.  Install the generated .vsix file and test as you will:
+
+        code --install-extension salesforcedx-vscode-mobile-<version>.vsix
+
+## Publishing the extension package
+
+Publishing of the package will be handled as GitHub Action initiated by a user responsible for publishing the package, once all testing and sign-off has occurred on the generated package.