@bubblewrap/cli
Version:
CLI tool to Generate TWA projects from a Web Manifest
225 lines (224 loc) • 10 kB
JavaScript
;
/*
* Copyright 2019 Google Inc. All Rights Reserved.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
Object.defineProperty(exports, "__esModule", { value: true });
exports.help = help;
const core_1 = require("@bubblewrap/core");
const strings_1 = require("../strings");
const HELP_MESSAGES = new Map([
['main', [
'bubblewrap [command] <options>',
'',
'',
'build ............... generates an Android APK from a TWA Project',
'help ................ shows this menu',
'init ................ initializes a new TWA Project',
'update .............. updates an existing TWA Project with the latest bubblewrap template',
'validate ............ validates if an URL matches the PWA Quality Criteria for Trusted' +
' Web Activity',
'install ............. installs the output application to a connected device',
'updateConfig ........ sets the paths of the jdk or the androidSdk to the given paths',
'doctor .............. checks that the jdk and the androidSdk are in place and at the' +
' correct version',
'merge ............... merges your web manifest into twaManifest.json',
'fingerprint ......... generates the assetlinks.json file and manages keys',
].join('\n')],
['init', [
'Usage:',
'',
'',
'bubblewrap init --manifest=[web-manifest-url]',
'',
'',
'Options:',
'--directory ........... path where to generate the project. Defaults to the current' +
' directory',
'--chromeosonly ........ specifies that the build will be used for Chrome OS only and' +
' prevents non-Chrome OS devices from installing the app.',
'--metaquest ........... specifies that the build will be compatible with Meta Quest' +
' devices.',
'--alphaDependencies ... enables features that depend on upcoming version of the ' +
' Android library for Trusted Web Activity or that are still unstable.',
].join('\n')],
['build', [
'Usage:',
'',
'',
'bubblewrap build',
'',
'',
'Options:',
'--skipPwaValidation ....... skips validating the wrapped PWA against the Quality Criteria',
'--skipSigning ............. skips signing the built APK and App Bundle',
'--signingKeyPath .......... path to keystore to use for signing the built APK and' +
' App Bundle; overrides signingKey.path specified in twa-manifest.json',
'--signingKeyAlias ......... key name; overrides signingKey.alias specified in' +
' twa-manifest.json',
'--skipSigning ............. skips signing the built APK and App Bundle',
'--manifest ................ directory where the client should look for twa-manifest.json',
].join('\n')],
['update', [
'Usage:',
'',
'',
'bubblewrap update',
'',
'',
'Options:',
'--appVersionName ........... version name to be used on on the upgrade. Ignored if ' +
'--skipVersionUpgrade is used',
'--skipVersionUpgrade ....... skips upgrading appVersion and appVersionCode',
'--manifest ................. directory where the client should look for twa-manifest.json',
].join('\n')],
['validate', [
'Usage:',
'',
'',
'bubblewrap validate --url=[pwa-url]',
].join('\n')],
['install', [
'Usage:',
'',
'',
'bubblewrap install',
'',
'',
'Options: ',
'--apkFile ................. path to the APK file to be installed. Defaults to ' +
'"./app-release-signed.apk"',
'--verbose ................. prints the adb command being executed',
].join('\n')],
['updateConfig', [
strings_1.enUS.updateConfigUsage,
'',
'',
'Options: ',
'',
'',
'--jdkPath ................. sets the jdk\'s path to the path given',
'--androidSdkPath .......... sets the androidSdk\'s path to the path given',
].join('\n')],
['doctor', [
'Usage:',
'',
'',
'bubblewrap doctor',
].join('\n')],
['merge', [
'Usage:',
'',
'',
'bubblewrap merge',
'',
'',
'Options: ',
'--appVersionName ........... version name to be used on on the upgrade. Ignored if ' +
'--skipVersionUpgrade is used',
'--skipVersionUpgrade ....... skips upgrading appVersion and appVersionCode',
'--ignore [fields-list]................. the fields which you would like to keep the same.',
'You can enter each key from your Web Manifest.',
].join('\n')],
['fingerprint', [
'Usage:',
'',
'',
'bubblewrap fingerprint [subcommand]',
'',
' Global fingerprint flags: ',
' --manifest=<manifest> ........ Path to the Trusted Web Activity configuration.',
'',
'',
' - add: adds a fingerprint to the project configuration.',
' Usage:',
' bubblewrap fingerprint add [SHA-256 fingerprint] <flags>',
'',
' Flags:',
' --name=<name> ...... a name for the fingerprint',
'',
'',
' - remove: removes a fingerprint from the project configuration.',
' Usage:',
' bubblewrap fingerprint remove [SHA-256 fingerprint] <flags>',
'',
'',
' - list: lists the fingerprints in the project configuration',
' Usage:',
' bubblewrap fingerprint list <flags>',
'',
'',
' - generateAssetLinks: Generates an AssetLinks file from the project configuration.',
' Usage:',
' bubblewrap fingerprint generateAssetLinks <flags>',
'',
' Flags:',
' --output=<name> .... path from where to load the project configuration.',
'',
].join('\n')],
['play', [
'Usage:',
'',
'',
'bubblewrap play [subcommand]',
'',
' Global play flags: ',
' --serviceAccountFile=<path> . Path to the the service account JSON file to set in',
' the twa-manifest.',
' --manifest=<manifestPath> ....... Path to the manifest file to use if not in',
' the current directory.',
'',
' - publish: publishes provided bundle to the Play Store.',
' Usage:',
' bubblewrap play publish <flags>',
'',
' Flags:',
' --track=<track> ............ A Google Play Store track to publish the bundle to',
' (defaults to internal track).',
' --appBundleLocation=<path> . Location of the appbundle to upload to Google Play',
' (defaults to current directory).',
'',
'',
' - retain: handles retaining of packages that are published on Google Play Store.',
' Usage:',
' bubblewrap play retain <flags>',
'',
' Flags:',
' --add=<add> ....... Bundles to retain for release',
' --remove=<remove> . Removes the specified bundle if no longer relevant.',
' --list ............ Shows a list of existing retained bundles in the',
' twa-manifest.json (not what is listed as retained in',
' Google Play Store).',
'',
' - versionCheck: runs the version check workflow. If the published version is higher than',
' that of the twaManifest, we assume that the version that exists locally',
' needs to be updated to a higher version.',
' Usage:',
' bubblewrap play versionCheck <flags>',
'',
' Flags:',
' --targetDirectory=<targetDirectory> . The directory that versionCheck should run in',
' (defaults to the current directory). This',
' should be your bubblewrap project directory.',
'',
].join('\n')],
]);
async function help(args, log = new core_1.ConsoleLog('help')) {
// minimist uses an `_` object to store details.
const command = args._[1];
const message = HELP_MESSAGES.get(command) || HELP_MESSAGES.get('main');
// We know we have a message for 'main', in case the command is invalid.
log.info(message);
return true;
}