expo-release-it 0.1.2 → 0.1.4

package/README.md

@@ -2,22 +2,28 @@
 
 ![expo-release-it thumbnail](./asset/social-image.png)
 
-Opinioned Expo CICD workflow CLI for building & uploading & submitting Expo CNG project on your machine
+Opinionated Expo CICD workflow CLI for building & uploading & submitting Expo projects on your machine
 
 > [!CAUTION]
-> This project is under developing.
+> This project is under development.
 
 # Features
 
-- No EAS
-- Manage Keys, Credentials, Metadatas in a simple way 
-- Working with CNG mode (also available with non CNG environment)
-- Build artifacts locally (`apk`, `aab`, `ipa`)
-- Upload artifacts to Google Play Console Internal Testing Track & iOS Testflight
-- Submit releases for review
+- 🎉 No **EAS**
+- 🩵 No headaches when understanding and managing **keys and credentials**
+- 🧩 Manage and sync **store metadata** easily
+- 🌍 Works with [Expo CNG](https://docs.expo.dev/workflow/continuous-native-generation/) mode (also available in non-CNG environments)
+- 📦 Build artifacts **locally** (`apk`, `aab`, `ipa`)
+- 🚀 Upload artifacts to Google Play Console Internal Testing Track and iOS TestFlight
+- ✅ Submit releases for review
 
 # Why?
 
+**You don't need Expo EAS and to understand how it works in most small projects and our machine is much faster than using the cloud.**
+
+<details>
+  <summary>Full Details</summary>
+
 Expo EAS is convenient, but it requires additional configuration files, console setup, and a conceptual understanding of Over-The-Air (OTA) updates. Also, builds must be performed on EAS Cloud, which is not free and can be slow.
 
 While EAS is useful for larger teams, if you are developing alone or with just a few people and question the need for such a process, `expo-release-it` is the answer.
@@ -26,32 +32,144 @@ Based on years of experience developing with React Native, I encourage a more tr
 
 This approach is much faster, simpler, and, most importantly, allows you to take full advantage of your computer’s fast CPU.
 
+OTA updates are a powerful tool in React Native, but to fully take advantage of them, you need a self-hosted CDN server, a version management console both in the cloud and inside the app, and you have to separately manage binary versions and bundle versions—all of which introduce significant complexity and semantic overhead that often outweigh the benefits of implementing OTA updates. Furthermore, due to a general lack of deep understanding about OTA updates, issues like native library version mismatches can occur frequently, so OTA updates are excluded by default.
+
+I’m also a big fan of OTA updates, and I’ve enjoyed a lot of efficiency when working in larger teams, but it always required setting up many supporting systems in advance.
+
 `expo-release-it` is a CLI tool that encapsulates the know-how I have gained over years of automating build and review processes.  
 Internally, it ports and integrates tools like Fastlane and Match to automate native binary builds and review requests.
 
 Therefore, this tool enforces an opinionated versioning, build, and review request workflow.  
 However, once you understand this approach, your app deployment process will become significantly faster.
 
+</details>
 
-# Requirements
+# Structurual Requirements
 
-- Match iOS, Android Binary build version like `1.0.0`
-- All Keys, Credentials(except iOS certificates & provisioning profiles) are stored in VCS
+- `Version Code(Android)` and `Builder Number(iOS)` are the same.
+- All Keys, Credentials(except iOS certificates & provisioning profiles served in Github separately) are stored in VCS
 
 # Getting Started
 
+## 1. Ruby, Bundler
+
+`expo-release-it` requires `bundler` of ruby is available in your environment to run `Fastlane` internally.
+
+If not, set up your environment so that `ruby` and `bundler` are available by following [Ruby Install Guide](https://www.ruby-lang.org/en/downloads/) 
+
+## 2. Prepare Keys & Credentials
+
+`init` command generates sample key files structure in `expo-release-it/key`. They are **noob files** and you must replace file contents.
+
+> [!IMPORTANT]
+**You must prepare all required key files in `expo-release-it/key` exactly the same filenames.**
+
+### `android_play_console_service_account.json`
+
+Google Play Console actions require authentication using Google Service Account.
+
+You can issue new Google Play Service Account by following Guide
+and prepare `json` file.
+
+- [How to Get Your Google Play JSON Key](https://help.radio.co/en/articles/6232140-how-to-get-your-google-play-json-key)
+
+### `android_release.keystore`
+
+Prepare your android release keystore file for **uploading** and **signing** Android build artifacts.
+
+Additional passwords, alias will be prompted during the `init` command and be stored in `keyholder.json`.
+
+- [Keystore generation with Android Studio](https://developer.android.com/studio/publish/app-signing.html#generate-key)
+- [Keystore generation with CLI](https://gist.github.com/henriquemenezes/70feb8fff20a19a65346e48786bedb8f)
+
+### `ios_app_store_connect_api_key`
+
+App Store Connect actions require authentication using App Store Connect Api Key(.p8) 
+
+Additional `issuer_id`, `key_id` values will be prompted during the `init` command and be stored in `keyholder.json`
+
+- [Guide](https://www.revenuecat.com/docs/service-credentials/itunesconnect-app-specific-shared-secret/app-store-connect-api-key-configuration)
+- [Apple Docs Guide](https://developer.apple.com/documentation/appstoreconnectapi/creating-api-keys-for-app-store-connect-api)
+
+## 3. Create & Configure app on the stores as much as possible
+
+Create and configure your application in Google Play Console & App Store Connect as many as possible.
 
+You'd have to fill your key & credentials information using `init` command and pull store metadatas using `pull` command later.
+
+## 4. Set binary version in expo config file.
+
+The following buildNumber, versionCode format `ABBBCCC` is not mandatory but recommended for readability. 
+
+If your expo config file is `app.json`, then set like the following.
+
+```json
+{
+  "expo": {
+    "version": "1.2.3",
+    "ios": {
+      "buildNumber": "1002003",
+    },
+    "android": {
+      "versionCode": 1002003,
+    },
+  }
+}
+
+```
+
+If your expo config file is `app.config.(js|ts|mjs|cjs)`, then set like the following.
+
+```typescript
+import type { ExpoConfig, ConfigContext } from 'expo/config';
+const VERSION_NAME = '1.2.3'; // VERSION_NAME variable is required.
+const VERSION_CODE = 1002003; // VERSION_CODE variable is required.
+
+export default ({ config }: ConfigContext): ExpoConfig => {
+  return {
+    ...config,
+    version: VERSION_NAME,
+    ios: {
+      buildNumber: VERSION_CODE + '',
+    },
+    android: {
+      versionCode: VERSION_CODE,
+    },
+  };
+};
+
+```
 
 # Usage
 
 ```shell
-npx expo-release-it (init|bump|build|upload|submit) [options]
+npx expo-release-it (init|bump|pull|build|upload|submit) [options]
 ```
 
+All commands are powered by [Commander.js](https://github.com/tj/commander.js?) means you can query all available options with `--help` or `-h`.
+
 ## init
 
+**Configure resources and environment**
+
+```shell
+npx expo-release-it init
+```
+
+The `init` command asks you for many form fields, and the information is saved in `expo-release-it/keyholder.json` in your project.
+
+Even after running `init`, you can manually edit `keyholder.json`, and all subsequent commands will use the updated values.
+
 ## bump
 
+**Bump binary release patch version with modifying app.json**
+
+```shell
+npx expo-release-it bump
+```
+
+## pull
+
 ## build
 
 ## upload
@@ -60,6 +178,9 @@ npx expo-release-it (init|bump|build|upload|submit) [options]
 
 # Limitation
 
+# Troubleshooting
+
+# Licenses
 
 - See [LICENSE](/LICENSE)
 

package/build/command/build.js

@@ -3,26 +3,26 @@ import fs from "fs-extra";
 import * as path from "path";
 var join2 = path.join;
 var resolve2 = path.resolve;
-function exist(path3) {
-  return fs.existsSync(path3);
+function exist(path2) {
+  return fs.existsSync(path2);
 }
-function isDir(path3) {
-  return exist(path3) && fs.lstatSync(path3).isDirectory();
+function isDir(path2) {
+  return exist(path2) && fs.lstatSync(path2).isDirectory();
 }
 function relativePath(from, to) {
   return path.relative(from, to);
 }
-function isFile(path3) {
-  return exist(path3) && fs.lstatSync(path3).isFile();
+function isFile(path2) {
+  return exist(path2) && fs.lstatSync(path2).isFile();
 }
-function read(path3) {
-  return fs.readFileSync(path3, { encoding: "utf8" });
+function read(path2) {
+  return fs.readFileSync(path2, { encoding: "utf8" });
 }
-function readdir(path3) {
-  return fs.readdirSync(path3);
+function readdir(path2) {
+  return fs.readdirSync(path2);
 }
-function readJsonSlow(path3) {
-  return fs.readJSONSync(path3);
+function readJsonSlow(path2) {
+  return fs.readJSONSync(path2);
 }
 function write(p, content) {
   const dir = path.dirname(p);
@@ -34,21 +34,21 @@ function write(p, content) {
 function copy(src, dest, options) {
   fs.copySync(src, dest, options);
 }
-function remove(path3) {
-  if (!exist(path3)) {
+function remove(path2) {
+  if (!exist(path2)) {
     return;
   }
-  if (fs.lstatSync(path3).isDirectory()) {
-    return fs.rmSync(path3, { force: true, recursive: true });
+  if (fs.lstatSync(path2).isDirectory()) {
+    return fs.rmSync(path2, { force: true, recursive: true });
   } else {
-    return fs.rmSync(path3, { force: true });
+    return fs.rmSync(path2, { force: true });
   }
 }
-async function iterateDir(path3, fn) {
-  if (!isDir(path3)) {
+async function iterateDir(path2, fn) {
+  if (!isDir(path2)) {
     return;
   }
-  for (const file of fs.readdirSync(path3)) {
+  for (const file of fs.readdirSync(path2)) {
     await fn(file);
   }
 }
@@ -58,8 +58,10 @@ var package_default = {
   name: "expo-release-it",
   module: "src/index.ts",
   type: "module",
-  version: "0.1.1",
+  version: "0.1.3",
   license: "MIT",
+  homepage: "https://github.com/mym0404/expo-release-it",
+  repository: "https://github.com/mym0404/expo-release-it",
   scripts: {
     build: "tsup",
     dev: "yarn run build && NODE_ENV=development node bin/expo-release-it.mjs",
@@ -115,7 +117,7 @@ var OptionHolder = {
   keyholderMap: {},
   templateDirNames: ["key"],
   projectDir: "",
-  outputOfInitDir: "",
+  resourcesDir: "",
   keyDir: "",
   keyholderFilePath: "",
   versionName: "",
@@ -139,18 +141,12 @@ async function iterateAllFiles(root, callback) {
 }
 
 // src/util/injectTemplatePlaceHolders.ts
-import * as path2 from "node:path";
 async function injectTemplatePlaceHolders(root) {
   await iterateAllFiles(root, async (filePath) => {
-    const dirPath = path2.dirname(filePath);
     let content = read(filePath);
     for (const [key, value] of Object.entries(OptionHolder.keyholderMap)) {
       content = content.replaceAll(`{{${key}}}`, value);
     }
-    content = content.replaceAll(
-      "{{key_dir_relative_path}}",
-      relativePath(dirPath, OptionHolder.keyDir)
-    );
     write(filePath, content);
   });
 }
@@ -194,6 +190,71 @@ ${msg.join(", ")}`)),
   dim: (...msg) => console.log(chalk2.dim(msg.join(", ")))
 };
 
+// src/util/MetadataSyncUtil.ts
+import chalk3 from "chalk";
+function copyIosMetadata(to) {
+  const iosDir = join2(OptionHolder.projectDir, "ios");
+  const nativeDir = join2(iosDir, "fastlane");
+  const metadataNativeDir = join2(nativeDir, "metadata");
+  const screenshotsNativeDir = join2(nativeDir, "screenshots");
+  const resourcesDir = join2(OptionHolder.resourcesDir, "metadata/ios");
+  const metadataResourcesDir = join2(resourcesDir, "metadata");
+  const screenshotsResourcesDir = join2(resourcesDir, "screenshots");
+  if (to === "resources") {
+    if (exist(metadataNativeDir) && exist(screenshotsNativeDir)) {
+      copy(metadataNativeDir, metadataResourcesDir);
+      copy(screenshotsNativeDir, screenshotsResourcesDir);
+      logger.done(
+        `iOS Metadata saved in ${chalk3.inverse(relativePath(OptionHolder.projectDir, resourcesDir))}. You can edit inside contents.`
+      );
+    } else {
+      logger.warn(
+        `iOS Metadata not found in ${chalk3.inverse(relativePath(OptionHolder.projectDir, nativeDir))}`
+      );
+    }
+  } else {
+    if (exist(metadataResourcesDir) && exist(screenshotsResourcesDir)) {
+      copy(metadataResourcesDir, metadataNativeDir);
+      copy(screenshotsResourcesDir, screenshotsNativeDir);
+      logger.done(
+        `iOS Metadata copyed to ${chalk3.inverse(relativePath(OptionHolder.projectDir, nativeDir))}`
+      );
+    } else {
+      logger.warn(
+        `iOS Metadata not found in ${chalk3.inverse(relativePath(OptionHolder.projectDir, resourcesDir))}`
+      );
+    }
+  }
+}
+function copyAndroidMetadata(to) {
+  const androidDir = join2(OptionHolder.projectDir, "android");
+  const nativeDir = join2(androidDir, "fastlane/metadata/android");
+  const resourcesDir = join2(OptionHolder.resourcesDir, "metadata/android");
+  if (to === "resouces") {
+    if (exist(nativeDir)) {
+      copy(nativeDir, resourcesDir);
+      logger.done(
+        `Android Metadata saved in ${chalk3.inverse(relativePath(OptionHolder.projectDir, resourcesDir))}. You can edit inside contents.`
+      );
+    } else {
+      logger.warn(
+        `Android Metadata not found in ${chalk3.inverse(relativePath(OptionHolder.projectDir, nativeDir))}`
+      );
+    }
+  } else {
+    if (exist(resourcesDir)) {
+      copy(resourcesDir, nativeDir);
+      logger.done(
+        `Android Metadata copyed to ${chalk3.inverse(relativePath(OptionHolder.projectDir, nativeDir))}`
+      );
+    } else {
+      logger.warn(
+        `Android Metadata not found in ${chalk3.inverse(relativePath(OptionHolder.projectDir, resourcesDir))}`
+      );
+    }
+  }
+}
+
 // src/util/setup/prepareAndroid.ts
 async function prepareAndroid() {
   const srcDir = resolve2(OptionHolder.cli.templateDir, "android");
@@ -215,8 +276,9 @@ async function prepareAndroid() {
     "Hydrate template placeholders",
     injectTemplatePlaceHolders(resolve2(destDir, "fastlane"))
   );
-  await exe({ cwd: destDir })`bundle install`;
+  await exe("bundle", ["install"], { cwd: destDir });
   logger.success("Bunder Install - Done");
+  copyAndroidMetadata("native");
 }
 async function replaceAndroidSigningConfig(destDir) {
   const buildGradleDirPath = resolve2(destDir, "app");
@@ -231,7 +293,7 @@ async function replaceAndroidSigningConfig(destDir) {
     `
   signingConfigs {
     debug {
-        storeFile file('${relativePath(buildGradleDirPath, resolve2(OptionHolder.outputOfInitDir, "key", "android_release_keystore.jks"))}')
+        storeFile file('${relativePath(buildGradleDirPath, resolve2(OptionHolder.resourcesDir, "key", "android_release.keystore"))}')
         storePassword '${android_keystore_store_password}'
         keyAlias '${android_keystore_key_alias}'
         keyPassword '${android_keystore_key_password}'
@@ -261,6 +323,8 @@ function throwError(message, e) {
 
 // src/util/setup/VersionUtil.ts
 import semver from "semver";
+var versionNameRegex = () => /const\s+VERSION_NAME\s*?=\s*?['"]([\d\.]*?)['"]\s*?;?/;
+var versionCodeRegex = () => /const\s+VERSION_CODE\s*?=\s*?(\d+)\s*?;?/;
 async function parseBinaryVersions() {
   const files = readdir(OptionHolder.projectDir);
   const jsConfigFiles = ["app.config.ts", "app.config.js", "app.config.cjs", "app.config.mjs"];
@@ -279,8 +343,8 @@ async function parseBinaryVersions() {
   async function parseFromJsConfigFile(filename) {
     const filePath = resolve2(OptionHolder.projectDir, filename);
     const content = read(filePath);
-    const VERSION_NAME = /const VERSION_NAME = '(.*?)';/.exec(content)?.[1];
-    const VERSION_CODE = /const VERSION_CODE = (.*?);/.exec(content)?.[1];
+    const VERSION_NAME = versionNameRegex().exec(content)?.[1];
+    const VERSION_CODE = versionCodeRegex().exec(content)?.[1];
     if (!VERSION_NAME) {
       throwError("cannot parse version name");
     }
@@ -328,10 +392,10 @@ async function setup() {
 }
 async function setupBasicOptions() {
   OptionHolder.projectDir = isDev ? resolve2("example") : resolve2(".");
-  OptionHolder.outputOfInitDir = resolve2(OptionHolder.projectDir, "expo-release-it");
-  OptionHolder.keyDir = resolve2(OptionHolder.outputOfInitDir, "key");
-  OptionHolder.keyholderFilePath = resolve2(OptionHolder.outputOfInitDir, "keyholder.json");
-  OptionHolder.tempDir = resolve2(OptionHolder.outputOfInitDir, ".temp");
+  OptionHolder.resourcesDir = resolve2(OptionHolder.projectDir, "expo-release-it");
+  OptionHolder.keyDir = resolve2(OptionHolder.resourcesDir, "key");
+  OptionHolder.keyholderFilePath = resolve2(OptionHolder.resourcesDir, "keyholder.json");
+  OptionHolder.tempDir = resolve2(OptionHolder.resourcesDir, ".temp");
 }
 
 // src/util/setup/prepareIos.ts
@@ -354,12 +418,13 @@ async function prepareIos() {
     "Hydrate template placeholders",
     injectTemplatePlaceHolders(resolve2(destDir, "fastlane"))
   );
-  await exe({ cwd: destDir })`bundle install`;
+  await exe("bundle", ["install"], { cwd: destDir });
   logger.success("Bunder Install - Done");
+  copyIosMetadata("native");
 }
 
 // src/command/build.ts
-import chalk4 from "chalk";
+import chalk5 from "chalk";
 
 // src/util/calculateElapsed.ts
 import { padZero } from "@mj-studio/js-util";
@@ -373,7 +438,7 @@ function calculateElapsed(t) {
 // src/util/input/InqueryInputs.ts
 import { select } from "@inquirer/prompts";
 import { is } from "@mj-studio/js-util";
-import chalk3 from "chalk";
+import chalk4 from "chalk";
 var InqueryInputs = {
   platform: async () => {
     if (!OptionHolder.input.platform) {
@@ -389,6 +454,21 @@ var InqueryInputs = {
       });
     }
   },
+  platformAll: async () => {
+    if (!OptionHolder.input.platformAll) {
+      OptionHolder.input.platformAll = await select({
+        message: constructInquirerFormattedMessage({
+          name: "Platform",
+          explanation: `Platforms to run action`
+        }),
+        choices: [
+          { name: "all", value: "all", description: "Both" },
+          { name: "ios", value: "ios", description: "Release ios" },
+          { name: "android", value: "android", description: "Release android" }
+        ]
+      });
+    }
+  },
   podinstall: async () => {
     if (OptionHolder.input.platform === "ios") {
       OptionHolder.input.pod = await select({
@@ -437,19 +517,19 @@ function constructInquirerFormattedMessage({
   referUrl,
   name
 }) {
-  let ret = `${chalk3.bold(name)}`;
+  let ret = `${chalk4.bold(name)}`;
   if (explanation) {
     ret += `
 
-${chalk3.italic.blue(explanation)}`;
+${chalk4.italic.blue(explanation)}`;
   }
   if (example) {
     ret += `
-${chalk3.italic(`${chalk3.greenBright("example    :")} ${example}`)}`;
+${chalk4.italic(`${chalk4.greenBright("example    :")} ${example}`)}`;
   }
   if (referUrl) {
     ret += `
-${chalk3.italic(`${chalk3.greenBright("references :")} ${chalk3.underline.blue(referUrl)}`)}`;
+${chalk4.italic(`${chalk4.greenBright("references :")} ${chalk4.underline.blue(referUrl)}`)}`;
   }
   if (explanation) {
     ret += "\n";
@@ -466,10 +546,10 @@ function getIosFastlaneOptions() {
     ...Object.entries(OptionHolder.keyholderMap).map(([k, v]) => `${k}:${v}`),
     `version_name:${OptionHolder.versionName}`,
     `version_code:${OptionHolder.versionCode}`,
-    `api_key_filepath:${resolve2(OptionHolder.keyDir, "ios_testflight_upload_api_key.p8")}`,
+    `api_key_filepath:${resolve2(OptionHolder.keyDir, "ios_app_store_connect_api_key.p8")}`,
     `upload_metadata:${OptionHolder.input.uploadMetadata}`,
-    `ipa_path:${resolve2(OptionHolder.outputOfInitDir, "output", "ios", "app.ipa")}`,
-    `ipa_dir:${resolve2(OptionHolder.outputOfInitDir, "output", "ios")}`,
+    `ipa_path:${resolve2(OptionHolder.resourcesDir, "output", "ios", "app.ipa")}`,
+    `ipa_dir:${resolve2(OptionHolder.resourcesDir, "output", "ios")}`,
     `ipa_name:app.ipa`
   ];
 }
@@ -481,13 +561,12 @@ async function build({ options }) {
   await setup();
   await promptInputs();
   logger.info("Build Started");
-  logger.info(`Version: ${OptionHolder.versionName}(${OptionHolder.versionCode})`);
   if (OptionHolder.input.platform === "ios") {
     await buildIos();
-    logger.success(`iOS Build ${chalk4.bold.inverse(calculateElapsed(startTime))}`);
+    logger.success(`iOS Build ${chalk5.bold.inverse(calculateElapsed(startTime))}`);
   } else {
     await buildAndroid();
-    logger.success(`Android Build ${chalk4.bold.inverse(calculateElapsed(startTime))}`);
+    logger.success(`Android Build ${chalk5.bold.inverse(calculateElapsed(startTime))}`);
   }
 }
 async function promptInputs() {
@@ -513,7 +592,7 @@ async function buildIos() {
     remove(resolve2(iosDir, ".xcode.env.local"));
     await exeEnv("bundle", ["exec", "fastlane", "build", ...getIosFastlaneOptions()]);
     logger.success(
-      `artifact generated: ${relativePath(OptionHolder.projectDir, resolve2(OptionHolder.outputOfInitDir, "output", "ios", "app.ipa"))}`
+      `artifact generated: ${relativePath(OptionHolder.projectDir, resolve2(OptionHolder.resourcesDir, "output", "ios", "app.ipa"))}`
     );
   }
 }
@@ -528,19 +607,15 @@ async function buildAndroid() {
     let buildOutputDir;
     let outputDir;
     if (OptionHolder.input.androidOutput === "aab") {
-      await spinner(
-        "Bundle AAB",
-        exeEnv(isWin ? "gradle.bat" : "./gradlew", ["app:bundleRelease"])
-      );
+      await exeEnv(isWin ? "gradle.bat" : "./gradlew", ["app:bundleRelease"]);
+      logger.done("Bundle AAB");
       buildOutputDir = resolve2(androidDir, "app", "build", "outputs", "bundle", "release");
-      outputDir = resolve2(OptionHolder.outputOfInitDir, "output", "android", "aab");
+      outputDir = resolve2(OptionHolder.resourcesDir, "output", "android", "aab");
     } else {
-      await spinner(
-        "Bundle APK",
-        exeEnv(isWin ? "gradle.bat" : "./gradlew", ["app:assembleRelease"])
-      );
+      await exeEnv(isWin ? "gradle.bat" : "./gradlew", ["app:assembleRelease"]);
+      logger.done("Assemble APK");
       buildOutputDir = resolve2(androidDir, "app", "build", "outputs", "apk", "release");
-      outputDir = resolve2(OptionHolder.outputOfInitDir, "output", "android", "apk");
+      outputDir = resolve2(OptionHolder.resourcesDir, "output", "android", "apk");
     }
     remove(outputDir);
     copy(buildOutputDir, outputDir);