@salesforce/plugin-lightning-dev 1.0.26-alpha.0

package/lib/shared/previewUtils.js

@@ -0,0 +1,397 @@
+/*
+ * Copyright (c) 2024, salesforce.com, inc.
+ * All rights reserved.
+ * Licensed under the BSD 3-Clause license.
+ * For full license text, see LICENSE.txt file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+// **********************************************************************************************
+// * TODO: When we finalize the implementation for the dev commands and things settle down, *
+// *       consider moving most of these into PreviewUtils of lwc-dev-mobile-core instead.      *
+// **********************************************************************************************
+import fs from 'node:fs';
+import https from 'node:https';
+import os from 'node:os';
+import path from 'node:path';
+import { Messages } from '@salesforce/core';
+import { AndroidUtils, CommonUtils, CryptoUtils, IOSUtils, PreviewUtils as LwcDevMobileCorePreviewUtils, Platform, } from '@salesforce/lwc-dev-mobile-core';
+import fetch from 'node-fetch';
+import { ConfigUtils, LOCAL_DEV_SERVER_DEFAULT_HTTP_PORT } from './configUtils.js';
+Messages.importMessagesDirectoryFromMetaUrl(import.meta.url);
+const messages = Messages.loadMessages('@salesforce/plugin-lightning-dev', 'lightning.dev.app');
+const DevPreviewAuraMode = 'DEVPREVIEW';
+export class PreviewUtils {
+    static generateWebSocketUrlForLocalDevServer(platform, ports, logger) {
+        return LwcDevMobileCorePreviewUtils.generateWebSocketUrlForLocalDevServer(platform, ports, logger);
+    }
+    /**
+     * Returns a pair of port numbers to be used by the local dev server for http and https.
+     *
+     * It starts by checking whether the user has configured a port in their config file.
+     * If so then we are only allowed to use that port, regardless of whether it is in use
+     * or not.
+     *
+     * If the user has not configured a port in their config file then we are free to choose
+     * one. We'll start with the default port (8081) and checks to see if it is in use or not.
+     * If it is in use then we increment the port number by 2 and check if it is in use or not.
+     * This process is repeated until a port that is not in use is found.
+     *
+     * @returns a pair of port numbers to be used by the local dev server for http and https.
+     */
+    static async getNextAvailablePorts() {
+        const userConfiguredPorts = await ConfigUtils.getLocalDevServerPorts();
+        if (userConfiguredPorts) {
+            return Promise.resolve(userConfiguredPorts);
+        }
+        const httpPort = await this.doGetNextAvailablePort(LOCAL_DEV_SERVER_DEFAULT_HTTP_PORT);
+        const httpsPort = await this.doGetNextAvailablePort(httpPort + 1);
+        return Promise.resolve({ httpPort, httpsPort });
+    }
+    /**
+     * Attempts to fetch the targeted mobile device for previewing.
+     *
+     * @param platform A mobile platform (iOS or Android)
+     * @param deviceId An optional device identifier (such as name or UDID)
+     * @param logger An optional logger to be used for logging
+     * @returns The iOS or Android device, or `undefined` if not found
+     */
+    static async getMobileDevice(platform, deviceId, logger) {
+        let device;
+        logger?.debug(`Attempting to get mobile device for platform ${platform}`);
+        if (deviceId) {
+            logger?.debug(`Attempting to get device ${deviceId}`);
+            device =
+                platform === Platform.ios
+                    ? (await IOSUtils.getSimulator(deviceId, logger)) ?? undefined
+                    : await AndroidUtils.fetchEmulator(deviceId, logger);
+        }
+        else {
+            logger?.debug('No particular device was targeted by the user...  fetching the first available device.');
+            const devices = platform === Platform.ios
+                ? await IOSUtils.getSupportedSimulators(logger)
+                : await AndroidUtils.fetchEmulators(logger);
+            if (devices && devices.length > 0) {
+                device = devices[0];
+            }
+        }
+        return Promise.resolve(device);
+    }
+    /**
+     * Attempts to boot a device.
+     *
+     * @param platform A mobile platform (iOS or Android)
+     * @param deviceId The identifier (such as name or UDID) of the target device
+     * @param logger An optional logger to be used for logging
+     * @returns For Android devices returns the emulator port number. For iOS devices returns `undefined`
+     */
+    static async bootMobileDevice(platform, deviceId, logger) {
+        logger?.debug(`Booting device ${deviceId}`);
+        let emulatorPort;
+        if (platform === Platform.ios) {
+            await IOSUtils.bootDevice(deviceId, true, logger); // will be no-op if already booted
+            await IOSUtils.launchSimulatorApp(logger);
+            logger?.debug('Device booted');
+        }
+        else {
+            emulatorPort = await AndroidUtils.startEmulator(deviceId, false, true, logger); // will be no-op if already booted
+            logger?.debug(`Device booted on port ${emulatorPort}`);
+        }
+        return Promise.resolve(emulatorPort);
+    }
+    /**
+     * Generates the proper set of arguments to be used for launching desktop browser and navigating to the right location.
+     *
+     * @param ldpServerUrl The URL for the local dev server
+     * @param entityId Record ID for the identity token
+     * @param appId An optional app id for a targeted LEX app
+     * @param targetOrg An optional org id
+     * @param auraMode An optional Aura Mode (defaults to DEVPREVIEW)
+     * @returns Array of arguments to be used by Org:Open command for launching desktop browser
+     */
+    static generateDesktopPreviewLaunchArguments(ldpServerUrl, entityId, appId, targetOrg, auraMode = DevPreviewAuraMode) {
+        // appPath will resolve to one of the following:
+        //
+        //   lightning/app/<appId> => when the user is targeting a specific LEX app
+        //               lightning => when the user is not targeting a specific LEX app
+        //
+        const appPath = appId ? `lightning/app/${appId}` : 'lightning';
+        // we prepend a '0.' to all of the params to ensure they will persist across browser redirects
+        const launchArguments = [
+            '--path',
+            `${appPath}?0.aura.ldpServerUrl=${ldpServerUrl}&0.aura.ldpServerId=${entityId}&0.aura.mode=${auraMode}`,
+        ];
+        if (targetOrg) {
+            launchArguments.push('--target-org', targetOrg);
+        }
+        return launchArguments;
+    }
+    /**
+     * Generates the proper set of arguments to be used for launching a mobile app with custom launch arguments.
+     *
+     * @param ldpServerUrl The URL for the local dev server
+     * @param entityId Record ID for the identity token
+     * @param appName An optional app name for a targeted LEX app
+     * @param appId An optional app id for a targeted LEX app
+     * @param auraMode An optional Aura Mode (defaults to DEVPREVIEW)
+     * @returns Array of arguments to be used as custom launch arguments when launching a mobile app.
+     */
+    static generateMobileAppPreviewLaunchArguments(ldpServerUrl, entityId, appName, appId, auraMode = DevPreviewAuraMode) {
+        const launchArguments = [];
+        if (appName) {
+            launchArguments.push({ name: 'LightningExperienceAppName', value: appName });
+        }
+        if (appId) {
+            launchArguments.push({ name: 'LightningExperienceAppID', value: appId });
+        }
+        launchArguments.push({ name: 'aura.ldpServerUrl', value: ldpServerUrl });
+        launchArguments.push({ name: 'aura.mode', value: auraMode });
+        launchArguments.push({ name: 'aura.ldpServerId', value: entityId });
+        return launchArguments;
+    }
+    /**
+     * Generates a self-signed certificate and saves it to a file at the specified location.
+     *
+     * @param platform A mobile platform (iOS or Android)
+     * @param saveLocation Path to a folder where the generated certificated will be saved to (defaults to the current working directory)
+     * @returns Path to the generated certificate file and the certificate data
+     */
+    static async generateSelfSignedCert(platform, saveLocation = '.') {
+        // See if we have previously generated cert data which is stored in the global config.
+        // If so then use that data otherwise generate new cert data and store it in the global config.
+        let data = await ConfigUtils.getCertData();
+        if (!data) {
+            data = CryptoUtils.generateSelfSignedCert('localhost', 2048, 820);
+            await ConfigUtils.writeCertData(data);
+        }
+        const basePath = path.resolve(CommonUtils.resolveUserHomePath(saveLocation));
+        const targetFile = platform === Platform.ios ? path.join(basePath, 'localhost.der') : path.join(basePath, 'localhost.pem');
+        // save to file
+        if (platform === Platform.ios) {
+            fs.writeFileSync(targetFile, data.derCertificate);
+        }
+        else {
+            fs.writeFileSync(targetFile, data.pemCertificate);
+        }
+        return { certData: data, certFilePath: targetFile };
+    }
+    /**
+     * Launches the specified mobile app on the specified device.
+     *
+     * @param platform A mobile platform (iOS or Android)
+     * @param deviceId The identifier (such as name or UDID) of the target device
+     * @param appConfig The app configuration containing info about the mobile app to be launched
+     * @param emulatorPort Optional - only needed when platform is Android and specifies the ADB port of the booted Android virtual device
+     * @param logger An optional logger to be used for logging
+     */
+    static async launchMobileApp(platform, appConfig, deviceId, emulatorPort, appBundlePath, logger) {
+        logger?.debug(`Attempting to launch mobile app ${appConfig.name}`);
+        // If appBundlePath is provided then the app will be installed from
+        // the bundle first then will be launched. Otherwise the assumption
+        // is that app is already installed.
+        if (platform === Platform.ios) {
+            await IOSUtils.launchAppInBootedSimulator(deviceId, appBundlePath, appConfig.id, appConfig.launch_arguments ?? [], logger);
+        }
+        else if (emulatorPort) {
+            // for Android, emulatorPort is required
+            await AndroidUtils.launchAppInBootedEmulator(appBundlePath, appConfig.id, appConfig.launch_arguments ?? [], appConfig.activity, emulatorPort, logger);
+        }
+    }
+    /**
+     * Verifies whether a particular app is installed on a mobile device.
+     *
+     * @param platform A mobile platform (iOS or Android)
+     * @param appConfig The app configuration containing info about the mobile app such as name and bundle/package id
+     * @param deviceId The identifier (such as name or UDID) of the target device
+     * @param emulatorPort Optional - only needed when platform is Android and specifies the ADB port of the booted Android virtual device
+     * @param logger An optional logger to be used for logging
+     * @returns `true` if app is installed, `false` otherwise
+     */
+    static async verifyMobileAppInstalled(platform, appConfig, deviceId, emulatorPort, logger) {
+        logger?.debug(`Checking if ${appConfig.id} is installed on device ${deviceId}`);
+        let result = '';
+        try {
+            if (platform === Platform.ios) {
+                result = CommonUtils.executeCommandSync(`xcrun simctl listapps ${deviceId} | grep "${appConfig.id}"`, undefined, logger);
+            }
+            else {
+                // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+                const resolvedEmulatorPort = emulatorPort;
+                result = await AndroidUtils.executeAdbCommand(`shell pm list packages | grep "${appConfig.id}"`, resolvedEmulatorPort, logger);
+            }
+        }
+        catch {
+            /* ignore and continue */
+        }
+        return Promise.resolve(result ? true : false);
+    }
+    /**
+     * Downloads the Salesforce Mobile App into a temp folder and returns the path to downloaded file.
+     *
+     * @param platform A mobile platform (iOS or Android)
+     * @param logger An optional logger to be used for logging
+     * @param progress An optional spinner indicator for reporting messages
+     * @param progress An optional progress indicator for reporting progress
+     * @returns The path to downloaded file.
+     */
+    static async downloadSalesforceMobileAppBundle(platform, logger, spinner, progress) {
+        const sfdcUrl = platform === Platform.ios
+            ? 'https://sfdc.co/salesforce-mobile-app-ios-simulator'
+            : 'https://sfdc.co/salesforce-mobile-app-android-emulator';
+        let fullUrl = '';
+        try {
+            spinner?.start(messages.getMessage('spinner.download.preparing'));
+            logger?.debug(`Attempting to resolve full url from ${sfdcUrl}`);
+            fullUrl = await this.fetchFullUrlFromSfdc(sfdcUrl);
+            logger?.debug(`Full url is ${fullUrl}`);
+        }
+        finally {
+            spinner?.stop();
+        }
+        const parsedUrl = new URL(fullUrl);
+        const pathname = parsedUrl.pathname;
+        const filename = path.basename(pathname);
+        const tempDir = os.tmpdir();
+        const downloadedFilePath = path.join(tempDir, filename);
+        if (fs.existsSync(downloadedFilePath)) {
+            logger?.debug(`Skip downloading because already downloaded to ${downloadedFilePath}`);
+            return Promise.resolve(downloadedFilePath);
+        }
+        logger?.debug(`Attempting to download from ${fullUrl} to ${downloadedFilePath}`);
+        const response = await fetch(fullUrl, { redirect: 'follow' });
+        if (!response.ok) {
+            return Promise.reject(new Error(response.statusText));
+        }
+        const totalSize = parseInt(response.headers.get('content-length') ?? '0', 10);
+        let downloadedSize = 0;
+        // Create a write stream to save the file
+        const fileStream = fs.createWriteStream(downloadedFilePath);
+        // If we can determine the expected total size then we can report progress
+        if (totalSize) {
+            progress?.start(100, undefined, {
+                title: messages.getMessage('spinner.downloading'),
+                format: '%s | {bar} | {percentage}%',
+            });
+        }
+        else {
+            spinner?.start(messages.getMessage('spinner.downloading'));
+        }
+        return new Promise((resolve, reject) => {
+            if (progress && totalSize) {
+                response.body?.on('data', (chunk) => {
+                    // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access
+                    downloadedSize += chunk.length;
+                    const percentage = parseFloat(Math.min((downloadedSize / totalSize) * 100, 100).toFixed(1));
+                    progress.update(percentage);
+                });
+            }
+            response.body?.pipe(fileStream);
+            response.body?.on('error', (err) => {
+                // on error, delete the partially downloaded file
+                try {
+                    fs.rmSync(downloadedFilePath);
+                }
+                catch {
+                    /* ignore and continue */
+                }
+                progress?.stop();
+                spinner?.stop();
+                reject(err);
+            });
+            fileStream.on('finish', () => {
+                progress?.finish();
+                spinner?.stop();
+                resolve(downloadedFilePath);
+            });
+        });
+    }
+    /**
+     * Given an sfdc.co shortened url it returns the actual/full url that this will redirect to.
+     *
+     * @param httpsUrl The sfdc.co shortened url
+     * @returns The actual/full url
+     */
+    static async fetchFullUrlFromSfdc(httpsUrl) {
+        return new Promise((resolve, reject) => {
+            https
+                .get(httpsUrl, (response) => {
+                let data = '';
+                response.on('data', (chunk) => {
+                    data += chunk;
+                });
+                response.on('end', () => {
+                    // sfdc.co urls will lead to an html page where, among other elements, there would be
+                    // an element with id='full-url' and whose value would be the url to redirect to, eg:
+                    // <h2 class="home-heading" style="word-wrap:break-word;" id="full-url">
+                    //      https://developer.salesforce.com/files/sfmobiletools/SalesforceApp-Simulator-248.061-iOS.zip
+                    // </h2>
+                    const regex = /<[^>]*id\s*=\s*["']full-url["'][^>]*>(.*?)<\/[^>]*>/i;
+                    const match = data.match(regex);
+                    if (match?.[1]) {
+                        resolve(match[1]);
+                    }
+                    else {
+                        resolve('');
+                    }
+                });
+            })
+                .on('error)', (error) => {
+                reject(error);
+            });
+        });
+    }
+    /**
+     * Extracts a ZIP archive to an output directory.
+     *
+     * @param zipFilePath The path to the ZIP archive
+     * @param outputDir An optional output directory - if omitted then defaults to the same directory as the ZIP file
+     * @param logger An optional logger to be used for logging
+     */
+    static async extractZIPArchive(zipFilePath, outputDir, logger) {
+        let archive = path.resolve(CommonUtils.resolveUserHomePath(zipFilePath));
+        let outDir = outputDir ? path.resolve(CommonUtils.resolveUserHomePath(outputDir)) : path.dirname(archive);
+        archive = CommonUtils.convertToUnixPath(archive);
+        outDir = CommonUtils.convertToUnixPath(outDir);
+        const cmd = process.platform === 'win32'
+            ? `powershell -Command "$ProgressPreference = 'SilentlyContinue'; Expand-Archive -Path \\"${archive}\\" -DestinationPath \\"${outDir}\\" -Force"`
+            : `unzip -o -qq ${archive} -d ${outDir}`;
+        logger?.debug(`Extracting archive ${zipFilePath}`);
+        await CommonUtils.executeCommandAsync(cmd, logger);
+    }
+    static async getEntityId(username) {
+        const identityData = await ConfigUtils.getIdentityData();
+        let entityId;
+        if (!identityData) {
+            return Promise.reject(new Error(messages.getMessage('error.identitydata')));
+        }
+        else {
+            entityId = identityData.usernameToServerEntityIdMap[username];
+            if (!entityId) {
+                return Promise.reject(new Error(messages.getMessage('error.identitydata.entityid')));
+            }
+            return entityId;
+        }
+    }
+    static async doGetNextAvailablePort(startingPort) {
+        let port = startingPort;
+        let done = false;
+        while (!done) {
+            const cmd = process.platform === 'win32' ? `netstat -an | find "LISTENING" | find ":${port}"` : `lsof -i :${port}`;
+            try {
+                const result = CommonUtils.executeCommandSync(cmd);
+                if (result.trim()) {
+                    port = port + 2; // that port is in use so try another
+                }
+                else {
+                    done = true;
+                }
+            }
+            catch (error) {
+                // On some platforms (like mac) if the command doesn't produce
+                // any results then that is considered an error but in our case
+                // that means the port is not in use and is ready for us to use.
+                done = true;
+            }
+        }
+        return Promise.resolve(port);
+    }
+}
+//# sourceMappingURL=previewUtils.js.map

package/lib/shared/previewUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"previewUtils.js","sourceRoot":"","sources":["../../src/shared/previewUtils.ts"],"names":[],"mappings":"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"}

package/lib/shared/prompt.d.ts

@@ -0,0 +1,4 @@
+export declare class PromptUtils {
+    static promptUserToSelectSite(sites: string[]): Promise<string>;
+    static promptUserToConfirmUpdate(siteName: string): Promise<boolean>;
+}

package/lib/shared/prompt.js

@@ -0,0 +1,25 @@
+/*
+ * Copyright (c) 2024, salesforce.com, inc.
+ * All rights reserved.
+ * Licensed under the BSD 3-Clause license.
+ * For full license text, see LICENSE.txt file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+import select from '@inquirer/select';
+import { confirm } from '@inquirer/prompts';
+export class PromptUtils {
+    static async promptUserToSelectSite(sites) {
+        const choices = sites.map((site) => ({ value: site }));
+        const response = await select({
+            message: 'Select a site:',
+            choices,
+        });
+        return response;
+    }
+    static async promptUserToConfirmUpdate(siteName) {
+        return confirm({
+            message: `An updated site bundle is available for "${siteName}". Would you like to download and apply the update?`,
+            default: true,
+        });
+    }
+}
+//# sourceMappingURL=prompt.js.map

package/lib/shared/prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../src/shared/prompt.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,MAAM,MAAM,kBAAkB,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAE5C,MAAM,OAAO,WAAW;IACf,MAAM,CAAC,KAAK,CAAC,sBAAsB,CAAC,KAAe;QACxD,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QACvD,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC;YAC5B,OAAO,EAAE,gBAAgB;YACzB,OAAO;SACR,CAAC,CAAC;QAEH,OAAO,QAAQ,CAAC;IAClB,CAAC;IAEM,MAAM,CAAC,KAAK,CAAC,yBAAyB,CAAC,QAAgB;QAC5D,OAAO,OAAO,CAAC;YACb,OAAO,EAAE,4CAA4C,QAAQ,qDAAqD;YAClH,OAAO,EAAE,IAAI;SACd,CAAC,CAAC;IACL,CAAC;CACF"}

package/messages/lightning.dev.app.md

@@ -0,0 +1,171 @@
+# summary
+
+Preview a Lightning Experience app locally and in real-time, without deploying it.
+
+# description
+
+Use Local Dev (Beta) to see local changes to your app in a real-time preview that you don't have to deploy or manually refresh. To let you quickly iterate on your Lightning web components (LWCs) and pages, your app preview automatically refreshes when Local Dev detects source code changes.
+
+When you edit these local files with Local Dev enabled, your org automatically reflects these changes.
+
+- Basic HTML and CSS edits to LWCs
+- JavaScript changes to LWCs that don't affect the component's public API
+- Importing new custom LWCs
+- Importing another instance of an existing LWC
+
+To apply any other local changes not listed above, you must deploy them to your org using the `sf project deploy start` command.
+
+When you make changes directly in your org (like saving new component properties), they're automatically deployed to your live app. To update your local version of the app with those changes, you must retrieve them from your org using the `sf project retrieve start` command.
+
+To learn more about Local Dev enablement, considerations, and limitations, see the Lightning Web Components Developer Guide.
+
+# flags.name.summary
+
+Name of the Lightning Experience app to preview.
+
+# flags.target-org.summary
+
+Username or alias of the target org. Not required if the `target-org` configuration variable is already set.
+
+# flags.device-type.summary
+
+Type of device to display the app preview.
+
+# flags.device-id.summary
+
+ID of the mobile device to display the preview if device type is set to `ios` or `android`. The default value is the ID of the first available mobile device.
+
+# error.username
+
+Org must have a valid user
+
+# error.identitydata
+
+Couldn't find identity data while generating preview arguments
+
+# error.identitydata.entityid
+
+Couldn't find entity ID while generating preview arguments
+
+# error.no-project
+
+This command is required to run from within a Salesforce project directory. %s
+
+# error.fetching.app-id
+
+Unable to determine App Id for %s
+
+# error.device.notfound
+
+Unable to find device %s
+
+# spinner.device.boot
+
+Booting device %s
+
+# spinner.cert.gen
+
+Generating self-signed certificate
+
+# spinner.extract.archive
+
+Extracting archive
+
+# spinner.download.preparing
+
+Preparing to download
+
+# spinner.downloading
+
+Downloading
+
+# trust.local.dev.server
+
+Note: Your desktop browser requires additional configuration to trust the local development server. See the documentation for more details.
+
+# certificate.installation.notice
+
+To use local preview on your device, you have to install a self-signed certificate on it. If you previously set up a certificate for your device, you can skip this step.
+
+# certificate.installation.skip.message
+
+Do you want to skip this step
+
+# certificate.installation.description
+
+Before proceeding, install the self-signed certificate on your device. The certificate file is located at
+
+`%s`
+
+To install the certificate, follow these steps:
+
+%s
+
+# certificate.installation.steps.ios
+
+1. Drag and drop the file onto your booted simulator.
+2. Click `Allow` to proceed with downloading the configuration file.
+3. Click `Close` and navigate to `Settings > General > VPN & Device Management > localhost`.
+4. Click `Install` in the title bar, in the warning window, and on the install button.
+5. In the `Profile Installed` view, confirm that the profile displays `Verified` and then click `Done`.
+6. Navigate to `Settings > General > About > Certificate Trust Settings`.
+7. Enable full trust for `localhost`.
+8. In the resulting warning pop-up, click `Continue`.
+
+# certificate.installation.steps.android
+
+1. Drag and drop the file onto your booted emulator.
+2. %s
+3. Navigate to the certificate file from step 1. (It's usually located in `/sdcard/download`).
+4. Follow the on-screen instructions to install it.
+5. Click `User credentials` under `Credential storage` and verify that your certificate is listed there.
+6. Click `Trusted credentials` under `Credential storage`. Then click `USER` and verify that page lists your certificate.
+
+# certificate.installation.steps.android.nav-target-api-24-25
+
+Navigate to `Settings > Security` and click `Install from SD card` under `Credential storage`.
+
+# certificate.installation.steps.android.nav-target-api-26-27
+
+Navigate to `Settings > Security & Location > Encryption & credentials` and click `Install from SD card` under `Credential storage`.
+
+# certificate.installation.steps.android.nav-target-api-28
+
+Navigate to `Settings > Security & Location > Advanced > Encryption & credentials` and click `Install from SD card` under `Credential storage`.
+
+# certificate.installation.steps.android.nav-target-api-29
+
+Navigate to `Settings > Security > Encryption & credentials` and click `Install from SD card` under `Credential storage`.
+
+# certificate.installation.steps.android.nav-target-api-30-32
+
+Navigate to `Settings > Security > Encryption & credentials` and click `Install a certificate` under `Credential storage`. Click `CA certificate`, and then click `Install anyway`.
+
+# certificate.installation.steps.android.nav-target-api-33
+
+Navigate to `Settings > Security > More security settings > Encryption & credentials` and click `Install a certificate` under `Credential storage`. Click `CA certificate`, and then click `Install anyway`.
+
+# certificate.installation.steps.android.nav-target-api-34-up
+
+Navigate to `Settings > Security & Privacy > More security & privacy > Encryption & credentials` and click `Install a certificate` under `Credential storage`. Click `CA certificate`, and then click `Install anyway`.
+
+# certificate.waiting
+
+After you install the certificate, press any key to continue...
+
+# mobileapp.notfound
+
+%s isn't installed on your device.
+
+# mobileapp.download
+
+%s isn't installed on your device. Do you want to download and install it?
+
+# examples
+
+- Preview the default app for the target org "myOrg" in a desktop environment:
+  <%= config.bin %> <%= command.id %> --target-org myOrg
+- Preview the app "myApp" for the target org "myOrg" in a desktop environment:
+  <%= config.bin %> <%= command.id %> --name MyApp --target-org myOrg --device-type desktop
+- Preview the default app for target org "myOrg" on an iOS device:
+  <%= config.bin %> <%= command.id %> --target-org myOrg --device-type ios --device-id "iPhone 15 Pro Max"

package/messages/lightning.dev.site.md

@@ -0,0 +1,37 @@
+# summary
+
+Preview an Experience Builder site locally and in real-time, without deploying it.
+
+# description
+
+Enable Local Dev to see local changes to your site in a real-time preview that you don't have to deploy or manually refresh. To let you quickly iterate on your Lightning web components (LWCs) and pages, your site preview automatically refreshes when Local Dev detects source code changes.
+
+When you edit these local files with Local Dev enabled, your org automatically reflects these changes.
+
+- Basic HTML and CSS edits to LWCs
+- JavaScript changes to LWCs that don't affect the component's public API
+- Importing new custom LWCs
+- Importing another instance of an existing LWC
+
+To apply any other local changes not listed above, you must deploy them to your org using the `sf project deploy start` command. Then republish your site and restart the server for the Local Dev experience.
+
+For more considerations and limitations, see the Lightning Web Components Developer Guide.
+
+# flags.name.summary
+
+Name of the Experience Builder site to preview. It has to match a site name from the current org.
+
+# flags.target-org.summary
+
+Username or alias of the target org. Not required if the `target-org` configuration variable is already set.
+
+# flags.debug.summary
+
+Enable Node Inspector to debug server-side rendering.
+
+# examples
+
+- Preview the site "Partner Central" from the org "myOrg":
+  <%= config.bin %> <%= command.id %> --name "Partner Central" --target-org myOrg
+- Preview the site "Partner Central" from the org "myOrg" with Node Inspector enabled:
+  <%= config.bin %> <%= command.id %> --name "Partner Central" --target-org myOrg --debug