appium-webdriveragent 13.1.0 → 13.1.1

package/CHANGELOG.md

@@ -1,3 +1,9 @@
+## [13.1.1](https://github.com/appium/WebDriverAgent/compare/v13.1.0...v13.1.1) (2026-05-22)
+
+### Bug Fixes
+
+* ship Scripts/embed-runner-icon.sh in the npm package ([#1141](https://github.com/appium/WebDriverAgent/issues/1141)) ([17ac1c1](https://github.com/appium/WebDriverAgent/commit/17ac1c16a0890ee0fbfe73504a3ff570dfe1a7bf)), closes [#1138](https://github.com/appium/WebDriverAgent/issues/1138)
+
 ## [13.1.0](https://github.com/appium/WebDriverAgent/compare/v13.0.0...v13.1.0) (2026-05-21)
 
 ### Features

package/Scripts/embed-runner-icon.sh

@@ -0,0 +1,87 @@
+#!/bin/bash
+# Embed the WDA app icon into the wrapping XCTRunner host app so the
+# installed WebDriverAgent shows the Appium logo on the iOS home screen
+# instead of a blank icon.
+#
+# Apple's USES_XCTRUNNER auto-generates a Runner.app around UI-testing
+# .xctest bundles but does not inherit icons from the test bundle's
+# asset catalog. actool produces AppIcon*.png + Assets.car inside
+# PlugIns/<product>.xctest/ where iOS never looks. This script lifts
+# them up to the Runner.app root and patches Info.plist accordingly.
+#
+# Limitations:
+#   - Touches XCTRunner internals; may need updates across Xcode versions.
+#   - iOS only; tvOS uses different "Brand Assets" and is not handled.
+#   - Cloud device farms that re-sign WDA must preserve these changes.
+
+set -euo pipefail
+
+RUNNER_APP="${BUILT_PRODUCTS_DIR}/${PRODUCT_NAME}-Runner.app"
+XCTEST="${RUNNER_APP}/PlugIns/${PRODUCT_NAME}.xctest"
+
+if [ ! -d "$RUNNER_APP" ]; then
+    echo "warning: ${PRODUCT_NAME}-Runner.app not found at $RUNNER_APP; skipping icon embed"
+    exit 0
+fi
+
+if [ ! -d "$XCTEST" ]; then
+    echo "warning: ${PRODUCT_NAME}.xctest not found inside Runner.app; skipping icon embed"
+    exit 0
+fi
+
+shopt -s nullglob
+ICONS=("$XCTEST"/AppIcon*.png)
+if [ ${#ICONS[@]} -eq 0 ]; then
+    echo "warning: no compiled AppIcon*.png found inside $XCTEST; skipping icon embed"
+    exit 0
+fi
+
+cp -f "${ICONS[@]}" "$RUNNER_APP/"
+if [ -f "$XCTEST/Assets.car" ]; then
+    cp -f "$XCTEST/Assets.car" "$RUNNER_APP/"
+fi
+
+PLIST="$RUNNER_APP/Info.plist"
+/usr/libexec/PlistBuddy -c "Delete :CFBundleIcons" "$PLIST" 2>/dev/null || true
+/usr/libexec/PlistBuddy -c "Delete :CFBundleIcons~ipad" "$PLIST" 2>/dev/null || true
+
+/usr/libexec/PlistBuddy -c "Add :CFBundleIcons dict" "$PLIST"
+/usr/libexec/PlistBuddy -c "Add :CFBundleIcons:CFBundlePrimaryIcon dict" "$PLIST"
+/usr/libexec/PlistBuddy -c "Add :CFBundleIcons:CFBundlePrimaryIcon:CFBundleIconName string AppIcon" "$PLIST"
+/usr/libexec/PlistBuddy -c "Add :CFBundleIcons:CFBundlePrimaryIcon:CFBundleIconFiles array" "$PLIST"
+/usr/libexec/PlistBuddy -c "Add :CFBundleIcons:CFBundlePrimaryIcon:CFBundleIconFiles:0 string AppIcon60x60" "$PLIST"
+
+/usr/libexec/PlistBuddy -c "Add :CFBundleIcons~ipad dict" "$PLIST"
+/usr/libexec/PlistBuddy -c "Add :CFBundleIcons~ipad:CFBundlePrimaryIcon dict" "$PLIST"
+/usr/libexec/PlistBuddy -c "Add :CFBundleIcons~ipad:CFBundlePrimaryIcon:CFBundleIconName string AppIcon" "$PLIST"
+/usr/libexec/PlistBuddy -c "Add :CFBundleIcons~ipad:CFBundlePrimaryIcon:CFBundleIconFiles array" "$PLIST"
+/usr/libexec/PlistBuddy -c "Add :CFBundleIcons~ipad:CFBundlePrimaryIcon:CFBundleIconFiles:0 string AppIcon60x60" "$PLIST"
+/usr/libexec/PlistBuddy -c "Add :CFBundleIcons~ipad:CFBundlePrimaryIcon:CFBundleIconFiles:1 string AppIcon76x76" "$PLIST"
+
+# Re-codesign since we modified the bundle after Xcode signed it.
+# In a scheme post-action context Xcode's CODE_SIGN_* env vars are not exposed,
+# so discover the existing signing identity from the already-signed bundle.
+if [ -d "$RUNNER_APP/_CodeSignature" ]; then
+    # Capture the signature info once. Piping codesign straight into
+    # `awk ... exit` makes awk close the pipe early, killing codesign with
+    # SIGPIPE -- which `set -o pipefail` turns into a fatal error. That trips
+    # only when an Authority line exists, i.e. on every real-device build.
+    SIGN_INFO=$(codesign -dvv "$RUNNER_APP" 2>&1 || true)
+    EXISTING_IDENT="${EXPANDED_CODE_SIGN_IDENTITY:-}"
+    if [ -z "$EXISTING_IDENT" ]; then
+        EXISTING_IDENT=$(awk -F'=' '/^Authority/ {print $2; exit}' <<< "$SIGN_INFO")
+    fi
+    # Simulator builds are ad-hoc signed: there is no Authority line, but the
+    # bundle can still be re-signed ad-hoc with an identity of "-".
+    if [ -z "$EXISTING_IDENT" ] && grep -q '^Signature=adhoc' <<< "$SIGN_INFO"; then
+        EXISTING_IDENT="-"
+    fi
+    if [ -n "$EXISTING_IDENT" ]; then
+        codesign --force --sign "$EXISTING_IDENT" \
+                 --preserve-metadata=identifier,entitlements "$RUNNER_APP"
+    else
+        echo "warning: bundle is signed but no identity discovered; signature will be invalid"
+    fi
+fi
+
+echo "embedded icon into $RUNNER_APP"

package/WebDriverAgentLib/Info.plist

@@ -15,11 +15,11 @@
     <key>CFBundlePackageType</key>
     <string>FMWK</string>
     <key>CFBundleShortVersionString</key>
-    <string>13.1.0</string>
+    <string>13.1.1</string>
     <key>CFBundleSignature</key>
     <string>????</string>
     <key>CFBundleVersion</key>
-    <string>13.1.0</string>
+    <string>13.1.1</string>
     <key>NSPrincipalClass</key>
     <string/>
   </dict>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "appium-webdriveragent",
-  "version": "13.1.0",
+  "version": "13.1.1",
   "description": "Package bundling WebDriverAgent",
   "main": "./build/lib/index.js",
   "types": "./build/lib/index.d.ts",
@@ -88,6 +88,7 @@
     "lib",
     "build/lib",
     "Scripts/build.sh",
+    "Scripts/embed-runner-icon.sh",
     "Scripts/*.mjs",
     "Configurations",
     "PrivateHeaders",