@expo/repack-app 0.1.13 → 0.1.15

package/README.md

@@ -2,103 +2,6 @@
 
 Repacking tool for Expo apps
 
-## Repack an onboarding app for Android
-
-1. Install repack-app
-
-```sh
-$ bun i
-```
-
-2. Generate golden apk
-
-```sh
-$ ./scripts/create-golden-apk.sh
-```
-
-The golden apk will be generated at **./golden-debug.apk**
-
-3. Have an onboarding app setup at /path/to/sdk51onboard
-
-4. Repack by cli
-
-```sh
-$ bun bin/cli.js -p android --source-app ./golden-debug.apk /path/to/sdk51onboard
-```
-
-5. Install the app
-
-```sh
-$ adb install -r /path/to/sdk51onboard/repacked.apk
-```
-
-## Repack an onboarding app for iOS simulators
-
-1. Install repack-app
-
-```sh
-$ bun i
-```
-
-2. Generate golden apk
-
-```sh
-$ ./scripts/create-golden-ipa.sh iphonesimulator
-```
-
-The golden apk will be generated at **./golden-debug-iphonesimulator.ipa**
-
-3. Have an onboarding app setup at /path/to/sdk51onboard
-
-4. Repack by cli
-
-```sh
-$ bun bin/cli.js -p ios --source-app ./golden-debug-iphonesimulator.ipa /path/to/sdk51onboard
-```
-
-5. Install the app
-
-```sh
-$ mkdir tmp && unzip /path/to/sdk51onboard/repacked.ipa -d tmp && xcrun simctl install booted tmp/Payload/*.app
-```
-
-## Repack an onboarding app for iOS devices
-
-1. Install repack-app
-
-```sh
-$ bun i
-```
-
-2. Generate golden apk
-
-```sh
-$ ./scripts/create-golden-ipa.sh iphoneos
-```
-
-The golden apk will be generated at **./golden-debug-iphoneos.ipa**
-
-3. Have an onboarding app setup at /path/to/sdk51onboard
-
-4. Repack by cli
-
-```sh
-$ bun bin/cli.js -p ios --source-app ./golden-debug-iphoneos.ipa /path/to/sdk51onboard
-# then resign the ipa maybe through fastlane resign
-
-# or the cli also provides a shorthand
-$ bun bin/cli.js -p ios --source-app ./golden-debug-iphoneos.ipa \
-    --signing-identity 'Apple Development: OOO (XXX)' \
-    --provisioning-profile "$HOME/Library/MobileDevice/Provisioning Profiles/e1cf123b-d33a-2b3e-073a-c7ed52aa61bb.mobileprovision" \
-    /path/to/sdk51onboard
-```
-
-5. Install the app
-
-```sh
-$ xcrun devicectl device install app --verbose --device <device-id> /path/to/sdk51onboard/repacked.ipa
-```
-
 ## API Documentation
 
 ### CLI Usage
@@ -119,14 +22,15 @@ repack-app [options] [project-root]
 #### Android-specific Options
 
 - `--ks <path>`: Path to the keystore file
-- `--ks-pass <password>`: Keystore password (default: "pass:android")
+- `--ks-pass <password>`: Keystore password (supports formats: `pass:<password>`, `env:<name>`, `file:<file>`)
 - `--ks-key-alias <alias>`: Keystore key alias
-- `--ks-key-pass <password>`: Keystore key password
+- `--ks-key-pass <password>`: Keystore key password (supports formats: `pass:<password>`, `env:<name>`, `file:<file>`)
 
 #### iOS-specific Options
 
-- `--signing-identity <identity>`: Signing identity (e.g., "Apple Development: Name (Team ID)")
-- `--provisioning-profile <path>`: Path to the provisioning profile
+- `--signing-identity <identity>`: Code signing identity
+- `--provisioning-profile <path>`: Path to the provisioning profile file(s)
+- `--keychain-path <path>`: Path to the keychain file for codesign
 
 #### Bundle Options
 
@@ -149,14 +53,17 @@ await repackAppAndroidAsync({
   verbose: true,
   androidSigningOptions: {
     keyStorePath: '/path/to/keystore.jks',
-    keyStorePassword: 'password',
+    keyStorePassword: 'pass:password', // or 'env:KEYSTORE_PASS' or 'file:/path/to/pass'
     keyAlias: 'alias',
-    keyPassword: 'key-password',
+    keyPassword: 'pass:key-password', // or 'env:KEY_PASS' or 'file:/path/to/key-pass'
   },
   androidBuildToolsDir: '/path/to/build-tools',
   exportEmbedOptions: {
     sourcemapOutput: '/path/to/sourcemap',
   },
+  env: {
+    // Additional environment variables
+  },
 });
 
 // For iOS
@@ -171,10 +78,14 @@ await repackAppIosAsync({
   iosSigningOptions: {
     signingIdentity: 'Apple Development: Name (Team ID)',
     provisioningProfile: '/path/to/profile.mobileprovision',
+    keychainPath: '/path/to/keychain', // Optional
   },
   exportEmbedOptions: {
     sourcemapOutput: '/path/to/sourcemap',
   },
+  env: {
+    // Additional environment variables
+  },
 });
 ```
 
@@ -193,18 +104,23 @@ The following options are available when using the API programmatically:
 - `exportEmbedOptions?`: ExportEmbedOptions - Options for embedding JS bundle
 - `skipWorkingDirCleanup?`: boolean - Skip working directory cleanup
 - `env?`: Record<string, string | undefined> - Environment variables
-- `logger?`: Logger - Custom logger instance
-- `spawnAsync?`: SpawnProcessAsync - Custom spawn process function
 
 #### Android-specific Options
 
 - `androidSigningOptions?`: AndroidSigningOptions - Options for signing the Android app
+  - `keyStorePath`: string - Path to the keystore file
+  - `keyStorePassword`: string - Keystore password (supports formats: `pass:<password>`, `env:<name>`, `file:<file>`)
+  - `keyAlias?`: string - Keystore key alias
+  - `keyPassword?`: string - Keystore key password (supports formats: `pass:<password>`, `env:<name>`, `file:<file>`)
 - `androidBuildToolsDir?`: string - Path to Android SDK build-tools directory
 
 #### iOS-specific Options
 
 - `iosSigningOptions?`: IosSigningOptions - Options for signing the iOS app
+  - `signingIdentity`: string - Code signing identity
+  - `provisioningProfile`: string | Record<string, string> - Path to provisioning profile file(s)
+  - `keychainPath?`: string - Path to the keychain file for codesign
 
-### Environment Variables
+## Environment Variables
 
 - `ANDROID_SDK_ROOT`: Path to the Android SDK root directory (required for Android builds)