@stim-cli/expo-build-cache 1.8.0 → 1.10.0

package/README.md

@@ -28,10 +28,21 @@ For current Expo SDK versions:
 
 Expo SDK 53 reads this value under `expo.experiments.buildCacheProvider`.
 
+Expo builds a debug APK without `--all-arch` only for the ABI of the device it
+targets. The provider keys those builds on that ABI, which it reads with `adb`
+(from `ANDROID_HOME`, `ANDROID_SDK_ROOT`, the default SDK location, or `PATH`)
+when exactly one device is online. With several devices online, or when `adb`
+does not answer, it skips the cache for that run and logs `[build-cache] skip
+android`. `--all-arch` builds have their own entry. These keys match the
+per-ABI builds `stim android` makes by default; a universal debug build that
+`stim android` makes with `optimizations.android.targetAbiOnly: false` is not
+shared with Expo runs.
+
 The provider works without the `stim` npm package. When Stim is available,
 the provider registers its cache so `stim gc` can report and trim it.
 
-Set `STIM_BUILD_CACHE` to override the cache location.
+Set `STIM_BUILD_CACHE` to an absolute path to override the cache location. A
+relative value is ignored with a warning.
 
 See the [cache package documentation](https://stim.appandflow.com/docs/cache-packages)
 for current setup and cleanup guidance.

package/dist/index.mjs

@@ -1,4 +1,5 @@
 import fs from "node:fs";
+import os from "node:os";
 import path from "node:path";
 import { artifactIn, buildCacheKey, buildCacheRoot, registerCache, resolveArtifact, storeArtifact } from "@stim-cli/core";
 import { execFileSync } from "node:child_process";
@@ -13,6 +14,67 @@ function entryDir(platform, key) {
 function shortKey(key, fingerprintHash) {
 	return `${String(fingerprintHash).slice(0, 12)}${key.slice(String(fingerprintHash).length)}`;
 }
+const ANDROID_ABIS = [
+	"armeabi-v7a",
+	"arm64-v8a",
+	"x86",
+	"x86_64"
+];
+function adbPath() {
+	const configured = process.env.ANDROID_HOME || process.env.ANDROID_SDK_ROOT;
+	const home = os.homedir();
+	const sdk = configured ? configured : [
+		path.join(home, "Library", "Android", "sdk"),
+		path.join(home, "Android", "Sdk"),
+		path.join(home, "Android", "sdk"),
+		path.join(home, "AppData", "Local", "Android", "Sdk")
+	].find((candidate) => fs.existsSync(path.join(candidate, "platform-tools")));
+	return sdk ? path.join(sdk, "platform-tools", "adb") : "adb";
+}
+function connectedDeviceAbi() {
+	try {
+		const adb = adbPath();
+		const serials = execFileSync(adb, ["devices"], {
+			encoding: "utf8",
+			timeout: 1e4,
+			stdio: [
+				"ignore",
+				"pipe",
+				"ignore"
+			]
+		}).split("\n").slice(1).map((line) => line.trim().split(/\s+/)).filter(([, state]) => state === "device").map(([serial]) => serial);
+		if (serials.length !== 1) return null;
+		return execFileSync(adb, [
+			"-s",
+			serials[0],
+			"shell",
+			"getprop",
+			"ro.product.cpu.abilist"
+		], {
+			encoding: "utf8",
+			timeout: 1e4,
+			stdio: [
+				"ignore",
+				"pipe",
+				"ignore"
+			]
+		}).trim().split(",").find((abi) => ANDROID_ABIS.includes(abi)) ?? null;
+	} catch {
+		return null;
+	}
+}
+function keyOptions(platform, runOptions = {}) {
+	if (platform !== "android" || runOptions.abi || runOptions.allArch) return runOptions;
+	const parts = (runOptions.variant || "debug").split(/(?=[A-Z])/);
+	let buildType = parts.pop();
+	if (parts.length > 0 && buildType === "Optimized") buildType = parts.pop() + buildType;
+	if (!/^debug(optimized)?$/i.test(buildType)) return runOptions;
+	const abi = connectedDeviceAbi();
+	return abi ? {
+		...runOptions,
+		abi
+	} : null;
+}
 function registerOnce() {
 	const root = cacheRoot();
 	if (registeredDir === root) return;
@@ -27,7 +89,12 @@ function registerOnce() {
 }
 async function resolveBuildCache({ platform, fingerprintHash, runOptions }) {
 	registerOnce();
-	const key = buildCacheKey(platform, fingerprintHash, runOptions);
+	const options = keyOptions(platform, runOptions);
+	if (!options) {
+		console.log(`[build-cache] skip ${platform}: cannot tell which ABI this debug build targets`);
+		return null;
+	}
+	const key = buildCacheKey(platform, fingerprintHash, options);
 	const hit = resolveArtifact(entryDir(platform, key));
 	if (hit) {
 		console.log(`[build-cache] hit ${platform} ${shortKey(key, fingerprintHash)}`);
@@ -39,17 +106,28 @@ async function resolveBuildCache({ platform, fingerprintHash, runOptions }) {
 async function uploadBuildCache({ platform, fingerprintHash, buildPath, runOptions }) {
 	registerOnce();
 	if (!buildPath || !fs.existsSync(buildPath)) return null;
-	const key = buildCacheKey(platform, fingerprintHash, runOptions);
+	const options = keyOptions(platform, runOptions);
+	if (!options) {
+		console.log(`[build-cache] skip ${platform}: cannot tell which ABI this debug build targets`);
+		return null;
+	}
+	const key = buildCacheKey(platform, fingerprintHash, options);
 	const dest = entryDir(platform, key);
 	if (artifactIn(dest)) return artifactIn(dest);
-	const stored = storeArtifact(dest, buildPath, {
-		runFile: execFileSync,
-		onRenameError: (staging) => fs.rmSync(staging, {
-			recursive: true,
-			force: true
-		})
-	});
-	console.log(`[build-cache] stored ${platform} ${shortKey(key, fingerprintHash)}`);
+	let stored;
+	try {
+		stored = storeArtifact(dest, buildPath, {
+			runFile: execFileSync,
+			onRenameError: (staging) => fs.rmSync(staging, {
+				recursive: true,
+				force: true
+			})
+		});
+	} catch (error) {
+		console.warn(`[build-cache] could not store ${platform} ${shortKey(key, fingerprintHash)}: ${error.message}`);
+		return null;
+	}
+	if (stored) console.log(`[build-cache] stored ${platform} ${shortKey(key, fingerprintHash)}`);
 	return stored;
 }
 //#endregion

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stim-cli/expo-build-cache",
-  "version": "1.8.0",
+  "version": "1.10.0",
   "description": "Local Expo build cache provider: installs a cached .app/.apk instead of compiling when no native input changed.",
   "license": "MIT",
   "repository": {
@@ -24,13 +24,12 @@
     }
   },
   "dependencies": {
-    "@stim-cli/core": "^1.8.0"
+    "@stim-cli/core": "^1.10.0"
   },
   "engines": {
     "node": ">=22.12.0"
   },
   "scripts": {
-    "test": "node --test test/*.test.js",
     "build": "tsdown"
   }
 }