appium-xcuitest-driver 7.13.0 → 7.15.0

package/CHANGELOG.md

@@ -1,3 +1,17 @@
+## [7.15.0](https://github.com/appium/appium-xcuitest-driver/compare/v7.14.0...v7.15.0) (2024-04-26)
+
+
+### Features
+
+* Avoid unzipping of real device .ipa bundles ([#2388](https://github.com/appium/appium-xcuitest-driver/issues/2388)) ([520168a](https://github.com/appium/appium-xcuitest-driver/commit/520168aa7d8c230a44da136b9e8d21971c4ef8f8))
+
+## [7.14.0](https://github.com/appium/appium-xcuitest-driver/compare/v7.13.0...v7.14.0) (2024-04-23)
+
+
+### Features
+
+* Perform bundles extraction in stream ([#2387](https://github.com/appium/appium-xcuitest-driver/issues/2387)) ([b04cebd](https://github.com/appium/appium-xcuitest-driver/commit/b04cebd99418b0e6d55d3c1813700779248e6541))
+
 ## [7.13.0](https://github.com/appium/appium-xcuitest-driver/compare/v7.12.0...v7.13.0) (2024-04-18)
 
 

package/build/lib/app-infos-cache.d.ts

@@ -0,0 +1,46 @@
+export class AppInfosCache {
+    /**
+     * @param {import('@appium/types').AppiumLogger} log
+     */
+    constructor(log: import('@appium/types').AppiumLogger);
+    log: import("@appium/types").AppiumLogger;
+    /**
+     *
+     * @param {string} appPath
+     * @param {string} propertyName
+     * @returns {Promise<any>}
+     */
+    extractManifestProperty(appPath: string, propertyName: string): Promise<any>;
+    /**
+     *
+     * @param {string} appPath
+     * @returns {Promise<string>}
+     */
+    extractBundleId(appPath: string): Promise<string>;
+    /**
+     *
+     * @param {string} appPath
+     * @returns {Promise<string>}
+     */
+    extractBundleVersion(appPath: string): Promise<string>;
+    /**
+     *
+     * @param {string} appPath
+     * @returns {Promise<string[]>}
+     */
+    extractAppPlatforms(appPath: string): Promise<string[]>;
+    /**
+     *
+     * @param {string} appPath
+     * @returns {Promise<string>}
+     */
+    extractExecutableName(appPath: string): Promise<string>;
+    /**
+     *
+     * @param {string} appPath Full path to the .ipa or .app bundle
+     * @returns {Promise<import('@appium/types').StringRecord>} The payload of the manifest plist
+     * @throws {Error} If the given app is not a valid bundle
+     */
+    put(appPath: string): Promise<import('@appium/types').StringRecord>;
+}
+//# sourceMappingURL=app-infos-cache.d.ts.map

package/build/lib/app-infos-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-infos-cache.d.ts","sourceRoot":"","sources":["../../lib/app-infos-cache.js"],"names":[],"mappings":"AAcA;IACE;;OAEG;IACH,iBAFW,OAAO,eAAe,EAAE,YAAY,EAI9C;IADC,0CAAc;IAGhB;;;;;OAKG;IACH,iCAJW,MAAM,gBACN,MAAM,GACJ,QAAQ,GAAG,CAAC,CAMxB;IAED;;;;OAIG;IACH,yBAHW,MAAM,GACJ,QAAQ,MAAM,CAAC,CAI3B;IAED;;;;OAIG;IACH,8BAHW,MAAM,GACJ,QAAQ,MAAM,CAAC,CAI3B;IAED;;;;OAIG;IACH,6BAHW,MAAM,GACJ,QAAQ,MAAM,EAAE,CAAC,CAQ7B;IAED;;;;OAIG;IACH,+BAHW,MAAM,GACJ,QAAQ,MAAM,CAAC,CAI3B;IAED;;;;;OAKG;IACH,aAJW,MAAM,GACJ,QAAQ,OAAO,eAAe,EAAE,YAAY,CAAC,CAgFzD;CACF"}

package/build/lib/app-infos-cache.js

@@ -0,0 +1,156 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AppInfosCache = void 0;
+const lodash_1 = __importDefault(require("lodash"));
+const path_1 = __importDefault(require("path"));
+const support_1 = require("appium/support");
+const lru_cache_1 = require("lru-cache");
+const bluebird_1 = __importDefault(require("bluebird"));
+/** @type {LRUCache<string, import('@appium/types').StringRecord>} */
+const MANIFEST_CACHE = new lru_cache_1.LRUCache({
+    max: 40,
+    updateAgeOnHas: true,
+});
+const MANIFEST_FILE_NAME = 'Info.plist';
+const MAX_MANIFEST_SIZE = 1024 * 1024; // 1 MiB
+class AppInfosCache {
+    /**
+     * @param {import('@appium/types').AppiumLogger} log
+     */
+    constructor(log) {
+        this.log = log;
+    }
+    /**
+     *
+     * @param {string} appPath
+     * @param {string} propertyName
+     * @returns {Promise<any>}
+     */
+    async extractManifestProperty(appPath, propertyName) {
+        const result = (await this.put(appPath))[propertyName];
+        this.log.debug(`${propertyName}: ${JSON.stringify(result)}`);
+        return result;
+    }
+    /**
+     *
+     * @param {string} appPath
+     * @returns {Promise<string>}
+     */
+    async extractBundleId(appPath) {
+        return await this.extractManifestProperty(appPath, 'CFBundleIdentifier');
+    }
+    /**
+     *
+     * @param {string} appPath
+     * @returns {Promise<string>}
+     */
+    async extractBundleVersion(appPath) {
+        return await this.extractManifestProperty(appPath, 'CFBundleVersion');
+    }
+    /**
+     *
+     * @param {string} appPath
+     * @returns {Promise<string[]>}
+     */
+    async extractAppPlatforms(appPath) {
+        const result = await this.extractManifestProperty(appPath, 'CFBundleSupportedPlatforms');
+        if (!Array.isArray(result)) {
+            throw new Error(`${path_1.default.basename(appPath)}': CFBundleSupportedPlatforms is not a valid list`);
+        }
+        return result;
+    }
+    /**
+     *
+     * @param {string} appPath
+     * @returns {Promise<string>}
+     */
+    async extractExecutableName(appPath) {
+        return await this.extractManifestProperty(appPath, 'CFBundleExecutable');
+    }
+    /**
+     *
+     * @param {string} appPath Full path to the .ipa or .app bundle
+     * @returns {Promise<import('@appium/types').StringRecord>} The payload of the manifest plist
+     * @throws {Error} If the given app is not a valid bundle
+     */
+    async put(appPath) {
+        const readPlist = async (/** @type {string} */ plistPath) => {
+            try {
+                return await support_1.plist.parsePlistFile(plistPath);
+            }
+            catch (e) {
+                this.log.debug(e.stack);
+                throw new Error(`Cannot parse ${MANIFEST_FILE_NAME} of '${appPath}'. Is it a valid application bundle?`);
+            }
+        };
+        if ((await support_1.fs.stat(appPath)).isFile()) {
+            /** @type {import('@appium/types').StringRecord|undefined} */
+            let manifestPayload;
+            /** @type {Error|undefined} */
+            let lastError;
+            try {
+                await support_1.zip.readEntries(appPath, async ({ entry, extractEntryTo }) => {
+                    if (!lodash_1.default.endsWith(entry.fileName, `.app/${MANIFEST_FILE_NAME}`)) {
+                        return true;
+                    }
+                    const hash = `${entry.crc32}`;
+                    if (MANIFEST_CACHE.has(hash)) {
+                        manifestPayload = MANIFEST_CACHE.get(hash);
+                        return false;
+                    }
+                    const tmpRoot = await support_1.tempDir.openDir();
+                    try {
+                        await extractEntryTo(tmpRoot);
+                        const plistPath = path_1.default.resolve(tmpRoot, entry.fileName);
+                        manifestPayload = await readPlist(plistPath);
+                        if (entry.uncompressedSize <= MAX_MANIFEST_SIZE && lodash_1.default.isPlainObject(manifestPayload)) {
+                            this.log.debug(`Caching the manifest for ${manifestPayload?.CFBundleIdentifier} app ` +
+                                `from an archived source using the key '${hash}'`);
+                            MANIFEST_CACHE.set(hash, manifestPayload);
+                        }
+                    }
+                    catch (e) {
+                        this.log.debug(e.stack);
+                        lastError = e;
+                    }
+                    finally {
+                        await support_1.fs.rimraf(tmpRoot);
+                    }
+                    return false;
+                });
+            }
+            catch (e) {
+                this.log.debug(e.stack);
+                throw new Error(`Cannot find ${MANIFEST_FILE_NAME} in '${appPath}'. Is it a valid application bundle?`);
+            }
+            if (!manifestPayload) {
+                let errorMessage = `Cannot extract ${MANIFEST_FILE_NAME} from '${appPath}'. Is it a valid application bundle?`;
+                if (lastError) {
+                    errorMessage += ` Original error: ${lastError.message}`;
+                }
+                throw new Error(errorMessage);
+            }
+            return manifestPayload;
+        }
+        // appPath points to a folder
+        const manifestPath = path_1.default.join(appPath, MANIFEST_FILE_NAME);
+        const hash = await support_1.fs.hash(manifestPath);
+        if (MANIFEST_CACHE.has(hash)) {
+            return /** @type {import('@appium/types').StringRecord} */ (MANIFEST_CACHE.get(hash));
+        }
+        const [payload, stat] = await bluebird_1.default.all([
+            readPlist(manifestPath),
+            support_1.fs.stat(manifestPath),
+        ]);
+        if (stat.size <= MAX_MANIFEST_SIZE && lodash_1.default.isPlainObject(payload)) {
+            this.log.debug(`Caching the manifest for ${payload.CFBundleIdentifier} app from a file source using the key '${hash}'`);
+            MANIFEST_CACHE.set(hash, payload);
+        }
+        return payload;
+    }
+}
+exports.AppInfosCache = AppInfosCache;
+//# sourceMappingURL=app-infos-cache.js.map

package/build/lib/app-infos-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-infos-cache.js","sourceRoot":"","sources":["../../lib/app-infos-cache.js"],"names":[],"mappings":"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"}

package/build/lib/app-utils.d.ts

@@ -1,62 +1,50 @@
 /**
+ * Verify whether the given application is compatible to the
+ * platform where it is going to be installed and tested.
  *
- * @param {string} app
- * @returns {Promise<string>}
+ * @this {XCUITestDriver}
+ * @returns {Promise<void>}
+ * @throws {Error} If bundle architecture does not match the expected device architecture.
  */
-export function extractBundleId(app: string): Promise<string>;
+export function verifyApplicationPlatform(this: import("./driver").XCUITestDriver): Promise<void>;
 /**
- *
- * @param {string} app
- * @returns {Promise<string>}
+ * @typedef {Object} LocalizableStringsOptions
+ * @property {string} [app]
+ * @property {string} [language='en']
+ * @property {string} [localizableStringsDir]
+ * @property {string} [stringFile]
+ * @property {boolean} [strictMode]
  */
-export function extractBundleVersion(app: string): Promise<string>;
 /**
+ * Extracts string resources from an app
  *
- * @param {string} app
- * @returns {Promise<string[]>}
+ * @this {XCUITestDriver}
+ * @param {LocalizableStringsOptions} opts
+ * @returns {Promise<import('@appium/types').StringRecord>}
  */
-export function fetchSupportedAppPlatforms(app: string): Promise<string[]>;
+export function parseLocalizableStrings(this: import("./driver").XCUITestDriver, opts?: LocalizableStringsOptions): Promise<import('@appium/types').StringRecord>;
 /**
- * @typedef {Object} PlatformOpts
- *
- * @property {boolean} isSimulator - Whether the destination platform is a Simulator
- * @property {boolean} isTvOS - Whether the destination platform is a Simulator
+ * @typedef {Object} UnzipInfo
+ * @property {string} rootDir
+ * @property {number} archiveSize
  */
 /**
- * Verify whether the given application is compatible to the
- * platform where it is going to be installed and tested.
- *
- * @param {string} app - The actual path to the application bundle
- * @param {PlatformOpts} expectedPlatform
- * @throws {Error} If bundle architecture does not match the expected device architecture.
- */
-export function verifyApplicationPlatform(app: string, expectedPlatform: PlatformOpts): Promise<void>;
-export function parseLocalizableStrings(opts: any): Promise<{}>;
-/**
- * Check whether the given path on the file system points to the .app bundle root
- *
- * @param {string} appPath Possible .app bundle root
- * @returns {Promise<boolean>} Whether the given path points to an .app bundle
- */
-export function isAppBundle(appPath: string): Promise<boolean>;
-/**
- * Extract the given archive and looks for items with given extensions in it
+ * Unzips a ZIP archive on the local file system.
  *
  * @param {string} archivePath Full path to a .zip archive
- * @param {Array<string>} appExtensions List of matching item extensions
- * @returns {Promise<[string, string[]]>} Tuple, where the first element points to
- * a temporary folder root where the archive has been extracted and the second item
- * contains a list of relative paths to matched items
+ * @returns {Promise<UnzipInfo>} temporary folder root where the archive has been extracted
  */
-export function findApps(archivePath: string, appExtensions: Array<string>): Promise<[string, string[]]>;
+export function unzipFile(archivePath: string): Promise<UnzipInfo>;
 /**
- * Moves the application bundle to a newly created temporary folder
+ * Unzips a ZIP archive from a stream.
+ * Uses bdstar tool for this purpose.
+ * This allows to optimize the time needed to prepare the app under test
+ * to MAX(download, unzip) instead of SUM(download, unzip)
  *
- * @param {string} appRoot Full path to the .app bundle
- * @returns {Promise<string>} The new path to the app bundle.
- * The name of the app bundle remains though
+ * @param {import('node:stream').Readable} zipStream
+ * @returns {Promise<UnzipInfo>}
  */
-export function isolateAppBundle(appRoot: string): Promise<string>;
+export function unzipStream(zipStream: import('node:stream').Readable): Promise<UnzipInfo>;
 /**
  * Builds Safari preferences object based on the given session capabilities
  *
@@ -64,17 +52,38 @@ export function isolateAppBundle(appRoot: string): Promise<string>;
  * @return {Promise<import('@appium/types').StringRecord>}
  */
 export function buildSafariPreferences(opts: import('./driver').XCUITestDriverOpts): Promise<import('@appium/types').StringRecord>;
+/**
+ * The callback invoked by configureApp helper
+ * when it is necessary to download the remote application.
+ * We assume the remote file could be anythingm, but only
+ * .zip and .ipa formats are supported.
+ * A .zip archive can contain one or more
+ *
+ * @this {XCUITestDriver}
+ * @param {import('@appium/types').DownloadAppOptions} opts
+ * @returns {Promise<string>}
+ */
+export function onDownloadApp(this: import("./driver").XCUITestDriver, { stream, headers }: import('@appium/types').DownloadAppOptions): Promise<string>;
+/**
+ * @this {XCUITestDriver}
+ * @param {import('@appium/types').PostProcessOptions} opts
+ * @returns {Promise<import('@appium/types').PostProcessResult|false>}
+ */
+export function onPostConfigureApp(this: import("./driver").XCUITestDriver, { cachedAppInfo, isUrl, appPath }: import('@appium/types').PostProcessOptions): Promise<import('@appium/types').PostProcessResult | false>;
 export const SAFARI_BUNDLE_ID: "com.apple.mobilesafari";
 export const APP_EXT: ".app";
 export const IPA_EXT: ".ipa";
-export type PlatformOpts = {
-    /**
-     * - Whether the destination platform is a Simulator
-     */
-    isSimulator: boolean;
-    /**
-     * - Whether the destination platform is a Simulator
-     */
-    isTvOS: boolean;
+export const SUPPORTED_EXTENSIONS: string[];
+export type LocalizableStringsOptions = {
+    app?: string | undefined;
+    language?: string | undefined;
+    localizableStringsDir?: string | undefined;
+    stringFile?: string | undefined;
+    strictMode?: boolean | undefined;
+};
+export type UnzipInfo = {
+    rootDir: string;
+    archiveSize: number;
 };
+export type XCUITestDriver = import('./driver').XCUITestDriver;
 //# sourceMappingURL=app-utils.d.ts.map

package/build/lib/app-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"app-utils.d.ts","sourceRoot":"","sources":["../../lib/app-utils.js"],"names":[],"mappings":"AAsDA;;;;GAIG;AACH,qCAHW,MAAM,GACJ,QAAQ,MAAM,CAAC,CAM3B;AAED;;;;GAIG;AACH,0CAHW,MAAM,GACJ,QAAQ,MAAM,CAAC,CAI3B;AAWD;;;;GAIG;AACH,gDAHW,MAAM,GACJ,QAAQ,MAAM,EAAE,CAAC,CAgB7B;AAED;;;;;GAKG;AAEH;;;;;;;GAOG;AACH,+CAJW,MAAM,oBACN,YAAY,iBA8CtB;AAWD,gEAyEC;AAED;;;;;GAKG;AACH,qCAHW,MAAM,GACJ,QAAQ,OAAO,CAAC,CAQ5B;AAED;;;;;;;;GAQG;AACH,sCANW,MAAM,iBACN,MAAM,MAAM,CAAC,GACX,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,CAiBvC;AAED;;;;;;GAMG;AACH,0CAJW,MAAM,GACJ,QAAQ,MAAM,CAAC,CAQ3B;AAED;;;;;GAKG;AACH,6CAHW,OAAO,UAAU,EAAE,kBAAkB,GACpC,QAAQ,OAAO,eAAe,EAAE,YAAY,CAAC,CAexD;AApTD,wDAAyD;AACzD,6BAA8B;AAC9B,6BAA8B;;;;;iBA8FhB,OAAO;;;;YACP,OAAO"}
+{"version":3,"file":"app-utils.d.ts","sourceRoot":"","sources":["../../lib/app-utils.js"],"names":[],"mappings":"AA8BA;;;;;;;GAOG;AACH,oFAHa,QAAQ,IAAI,CAAC,CA4CzB;AAgBD;;;;;;;GAOG;AAEH;;;;;;GAMG;AACH,wFAHW,yBAAyB,GACvB,QAAQ,OAAO,eAAe,EAAE,YAAY,CAAC,CA6FzD;AA0BD;;;;GAIG;AAEH;;;;;GAKG;AACH,uCAHW,MAAM,GACJ,QAAQ,SAAS,CAAC,CAiB9B;AAED;;;;;;;;GAQG;AACH,uCAHW,OAAO,aAAa,EAAE,QAAQ,GAC5B,QAAQ,SAAS,CAAC,CAoD9B;AAoJD;;;;;GAKG;AACH,6CAHW,OAAO,UAAU,EAAE,kBAAkB,GACpC,QAAQ,OAAO,eAAe,EAAE,YAAY,CAAC,CAexD;AAyGD;;;;;;;;;;GAUG;AACH,4FAHW,OAAO,eAAe,EAAE,kBAAkB,GACxC,QAAQ,MAAM,CAAC,CAM3B;AAED;;;;GAIG;AACH,+GAHW,OAAO,eAAe,EAAE,kBAAkB,GACxC,QAAQ,OAAO,eAAe,EAAE,iBAAiB,GAAC,KAAK,CAAC,CA2CpE;AA9nBD,wDAAyD;AACzD,6BAA8B;AAC9B,6BAA8B;AAW9B,4CAAuD;;;;;;;;;aA4MzC,MAAM;iBACN,MAAM;;6BAuaP,OAAO,UAAU,EAAE,cAAc"}