@appzung/react-native-code-push 9.0.2 → 10.0.0-rc1

package/android/app/.gradle/config.properties

@@ -0,0 +1,2 @@
+#Wed Jan 22 01:48:35 CET 2025
+java.home=/Users/louislagrange/Applications/Android Studio.app/Contents/jbr/Contents/Home

package/android/app/build.gradle

@@ -6,7 +6,7 @@ def DEFAULT_TARGET_SDK_VERSION = 26
 def DEFAULT_MIN_SDK_VERSION = 16
 
 android {
-    namespace "com.microsoft.codepush.react"
+    namespace "com.appzung.codepush.react"
 
     compileSdkVersion rootProject.hasProperty('compileSdkVersion') ? rootProject.compileSdkVersion : DEFAULT_COMPILE_SDK_VERSION
     buildToolsVersion rootProject.hasProperty('buildToolsVersion') ? rootProject.buildToolsVersion : DEFAULT_BUILD_TOOLS_VERSION

package/android/app/local.properties

@@ -0,0 +1,8 @@
+## This file must *NOT* be checked into Version Control Systems,
+# as it contains information specific to your local configuration.
+#
+# Location of the SDK. This is only used by Gradle.
+# For customization when using a Version Control System, please read the
+# header note.
+#Wed Jan 22 01:48:35 CET 2025
+sdk.dir=/Users/louislagrange/Library/Android/sdk

package/android/app/src/main/java/com/microsoft/codepush/react/CodePush.java

@@ -1,4 +1,4 @@
-package com.microsoft.codepush.react;
+package com.appzung.codepush.react;
 
 import android.content.Context;
 import android.content.pm.PackageInfo;
@@ -39,7 +39,7 @@ public class CodePush implements ReactPackage {
     private SettingsManager mSettingsManager;
 
     // Config properties.
-    private String mDeploymentKey;
+    private String mReleaseChannelPublicId;
     private static String mServerUrl = "https://codepush.appzung.com/";
 
     private Context mContext;
@@ -50,20 +50,20 @@ public class CodePush implements ReactPackage {
     private static ReactInstanceHolder mReactInstanceHolder;
     private static CodePush mCurrentInstance;
 
-    public CodePush(String deploymentKey, Context context) {
-        this(deploymentKey, context, false);
+    public CodePush(String releaseChannelPublicId, Context context) {
+        this(releaseChannelPublicId, context, false);
     }
 
     public static String getServiceUrl() {
         return mServerUrl;
     }
 
-    public CodePush(String deploymentKey, Context context, boolean isDebugMode) {
+    public CodePush(String releaseChannelPublicId, Context context, boolean isDebugMode) {
         mContext = context.getApplicationContext();
 
         mUpdateManager = new CodePushUpdateManager(context.getFilesDir().getAbsolutePath());
         mTelemetryManager = new CodePushTelemetryManager(mContext);
-        mDeploymentKey = deploymentKey;
+        mReleaseChannelPublicId = releaseChannelPublicId;
         mIsDebugMode = isDebugMode;
         mSettingsManager = new SettingsManager(mContext);
 
@@ -78,8 +78,11 @@ public class CodePush implements ReactPackage {
 
         mCurrentInstance = this;
 
-        String publicKeyFromStrings = getCustomPropertyFromStringsIfExist("PublicKey");
-        if (publicKeyFromStrings != null) mPublicKey = publicKeyFromStrings;
+        String publicKeyFromStrings = getCustomPropertyFromStringsIfExist("SigningPublicKey");
+        if (publicKeyFromStrings != null) {
+            CodePushUtils.log("Executing CodePush with a signing public key.");
+            mPublicKey = publicKeyFromStrings;
+        }
 
         String serverUrlFromStrings = getCustomPropertyFromStringsIfExist("ServerUrl");
         if (serverUrlFromStrings != null) mServerUrl = serverUrlFromStrings;
@@ -88,19 +91,19 @@ public class CodePush implements ReactPackage {
         initializeUpdateAfterRestart();
     }
 
-    public CodePush(String deploymentKey, Context context, boolean isDebugMode, String serverUrl) {
-        this(deploymentKey, context, isDebugMode);
+    public CodePush(String releaseChannelPublicId, Context context, boolean isDebugMode, String serverUrl) {
+        this(releaseChannelPublicId, context, isDebugMode);
         mServerUrl = serverUrl;
     }
 
-    public CodePush(String deploymentKey, Context context, boolean isDebugMode, int publicKeyResourceDescriptor) {
-        this(deploymentKey, context, isDebugMode);
+    public CodePush(String releaseChannelPublicId, Context context, boolean isDebugMode, int publicKeyResourceDescriptor) {
+        this(releaseChannelPublicId, context, isDebugMode);
 
         mPublicKey = getPublicKeyByResourceDescriptor(publicKeyResourceDescriptor);
     }
 
-    public CodePush(String deploymentKey, Context context, boolean isDebugMode, String serverUrl, Integer publicKeyResourceDescriptor) {
-        this(deploymentKey, context, isDebugMode);
+    public CodePush(String releaseChannelPublicId, Context context, boolean isDebugMode, String serverUrl, Integer publicKeyResourceDescriptor) {
+        this(releaseChannelPublicId, context, isDebugMode);
 
         if (publicKeyResourceDescriptor != null) {
             mPublicKey = getPublicKeyByResourceDescriptor(publicKeyResourceDescriptor);
@@ -124,15 +127,18 @@ public class CodePush implements ReactPackage {
         if (publicKey.isEmpty()) {
             throw new CodePushInvalidPublicKeyException("Specified public key is empty");
         }
+
+        CodePushUtils.log("Executing CodePush with a signing public key.");
+
         return publicKey;
     }
 
     private String getCustomPropertyFromStringsIfExist(String propertyName) {
         String property;
-      
+
         String packageName = mContext.getPackageName();
         int resId = mContext.getResources().getIdentifier("CodePush" + propertyName, "string", packageName);
-        
+
         if (resId != 0) {
             property = mContext.getString(resId);
 
@@ -140,7 +146,7 @@ public class CodePush implements ReactPackage {
                 return property;
             } else {
                 CodePushUtils.log("Specified " + propertyName + " is empty");
-            } 
+            }
         }
 
         return null;
@@ -230,8 +236,8 @@ public class CodePush implements ReactPackage {
         return mContext;
     }
 
-    public String getDeploymentKey() {
-        return mDeploymentKey;
+    public String getReleaseChannelPublicId() {
+        return mReleaseChannelPublicId;
     }
 
     public static String getJSBundleFile() {
@@ -393,8 +399,8 @@ public class CodePush implements ReactPackage {
         return sTestConfigurationFlag;
     }
 
-    public void setDeploymentKey(String deploymentKey) {
-        mDeploymentKey = deploymentKey;
+    public void setReleaseChannelPublicId(String releaseChannelPublicId) {
+        mReleaseChannelPublicId = releaseChannelPublicId;
     }
 
     public static void setUsingTestConfiguration(boolean shouldUseTestConfiguration) {

package/android/app/src/main/java/com/microsoft/codepush/react/CodePushBuilder.java

@@ -1,17 +1,17 @@
-package com.microsoft.codepush.react;
+package com.appzung.codepush.react;
 
 import android.content.Context;
 
 public class CodePushBuilder {
-    private String mDeploymentKey;
+    private String mReleaseChannelPublicId;
     private Context mContext;
 
     private boolean mIsDebugMode;
     private String mServerUrl;
     private Integer mPublicKeyResourceDescriptor;
 
-    public CodePushBuilder(String deploymentKey, Context context) {
-        this.mDeploymentKey = deploymentKey;
+    public CodePushBuilder(String releaseChannelPublicId, Context context) {
+        this.mReleaseChannelPublicId = releaseChannelPublicId;
         this.mContext = context;
         this.mServerUrl = CodePush.getServiceUrl();
     }
@@ -32,6 +32,6 @@ public class CodePushBuilder {
     }
 
     public CodePush build() {
-        return new CodePush(this.mDeploymentKey, this.mContext, this.mIsDebugMode, this.mServerUrl, this.mPublicKeyResourceDescriptor);
+        return new CodePush(this.mReleaseChannelPublicId, this.mContext, this.mIsDebugMode, this.mServerUrl, this.mPublicKeyResourceDescriptor);
     }
 }

package/android/app/src/main/java/com/microsoft/codepush/react/CodePushConstants.java

@@ -1,4 +1,4 @@
-package com.microsoft.codepush.react;
+package com.appzung.codepush.react;
 
 public class CodePushConstants {
     public static final String ASSETS_BUNDLE_PREFIX = "assets://";

package/android/app/src/main/java/com/microsoft/codepush/react/CodePushDialog.java

@@ -1,4 +1,4 @@
-package com.microsoft.codepush.react;
+package com.appzung.codepush.react;
 
 import android.app.Activity;
 import android.app.AlertDialog;

package/android/app/src/main/java/com/microsoft/codepush/react/CodePushInstallMode.java

@@ -1,4 +1,4 @@
-package com.microsoft.codepush.react;
+package com.appzung.codepush.react;
 
 public enum CodePushInstallMode {
     IMMEDIATE(0),
@@ -13,4 +13,4 @@ public enum CodePushInstallMode {
     public int getValue() {
         return this.value;
     }
-}
+}

package/android/app/src/main/java/com/microsoft/codepush/react/CodePushInvalidPublicKeyException.java

@@ -1,4 +1,4 @@
-package com.microsoft.codepush.react;
+package com.appzung.codepush.react;
 
 class CodePushInvalidPublicKeyException extends RuntimeException {
 
@@ -9,4 +9,4 @@ class CodePushInvalidPublicKeyException extends RuntimeException {
     public CodePushInvalidPublicKeyException(String message) {
         super(message);
     }
-}
+}

package/android/app/src/main/java/com/microsoft/codepush/react/CodePushInvalidUpdateException.java

@@ -1,4 +1,4 @@
-package com.microsoft.codepush.react;
+package com.appzung.codepush.react;
 
 public class CodePushInvalidUpdateException extends RuntimeException {
     public CodePushInvalidUpdateException(String message) {

package/android/app/src/main/java/com/microsoft/codepush/react/CodePushMalformedDataException.java

@@ -1,4 +1,4 @@
-package com.microsoft.codepush.react;
+package com.appzung.codepush.react;
 
 import java.net.MalformedURLException;
 
@@ -9,4 +9,4 @@ public class CodePushMalformedDataException extends RuntimeException {
     public CodePushMalformedDataException(String url, MalformedURLException cause) {
         super("The package has an invalid downloadUrl: " + url, cause);
     }
-}
+}

package/android/app/src/main/java/com/microsoft/codepush/react/CodePushNativeModule.java

@@ -1,4 +1,4 @@
-package com.microsoft.codepush.react;
+package com.appzung.codepush.react;
 
 import android.app.Activity;
 import android.content.SharedPreferences;
@@ -156,7 +156,7 @@ public class CodePushNativeModule extends ReactContextBaseJavaModule {
                 @Override
                 public void run() {
                     try {
-                        // We don't need to resetReactRootViews anymore 
+                        // We don't need to resetReactRootViews anymore
                         // due the issue https://github.com/facebook/react-native/issues/14533
                         // has been fixed in RN 0.46.0
                         //resetReactRootViews(instanceManager);
@@ -365,7 +365,7 @@ public class CodePushNativeModule extends ReactContextBaseJavaModule {
             WritableMap configMap =  Arguments.createMap();
             configMap.putString("appVersion", mCodePush.getAppVersion());
             configMap.putString("clientUniqueId", mClientUniqueId);
-            configMap.putString("deploymentKey", mCodePush.getDeploymentKey());
+            configMap.putString("releaseChannelPublicId", mCodePush.getReleaseChannelPublicId());
             configMap.putString("serverUrl", mCodePush.getServerUrl());
 
             // The binary hash may be null in debug builds
@@ -492,7 +492,7 @@ public class CodePushNativeModule extends ReactContextBaseJavaModule {
                             return null;
                         }
                     }
-                    
+
                     promise.resolve("");
                 } catch(CodePushUnknownException e) {
                     CodePushUtils.log(e);
@@ -691,7 +691,7 @@ public class CodePushNativeModule extends ReactContextBaseJavaModule {
 
     /**
      * This method clears CodePush's downloaded updates.
-     * It is needed to switch to a different deployment if the current deployment is more recent.
+     * It is needed to switch to a different release channel if the current release channel is more recent.
      * Note: we don’t recommend to use this method in scenarios other than that (CodePush will call
      * this method automatically when needed in other cases) as it could lead to unpredictable
      * behavior.

package/android/app/src/main/java/com/microsoft/codepush/react/CodePushNotInitializedException.java

@@ -1,4 +1,4 @@
-package com.microsoft.codepush.react;
+package com.appzung.codepush.react;
 
 public final class CodePushNotInitializedException extends RuntimeException {
 
@@ -9,4 +9,4 @@ public final class CodePushNotInitializedException extends RuntimeException {
     public CodePushNotInitializedException(String message) {
         super(message);
     }
-}
+}

package/android/app/src/main/java/com/microsoft/codepush/react/CodePushTelemetryManager.java

@@ -1,4 +1,4 @@
-package com.microsoft.codepush.react;
+package com.appzung.codepush.react;
 
 import android.content.Context;
 import android.content.SharedPreferences;
@@ -14,12 +14,12 @@ public class CodePushTelemetryManager {
     private SharedPreferences mSettings;
     private final String APP_VERSION_KEY = "appVersion";
     private final String DEPLOYMENT_FAILED_STATUS = "DeploymentFailed";
-    private final String DEPLOYMENT_KEY_KEY = "deploymentKey";
+    private final String RELEASE_CHANNEL_PUBLIC_ID_KEY = "releaseChannelPublicId";
     private final String DEPLOYMENT_SUCCEEDED_STATUS = "DeploymentSucceeded";
     private final String LABEL_KEY = "label";
     private final String LAST_DEPLOYMENT_REPORT_KEY = "CODE_PUSH_LAST_DEPLOYMENT_REPORT";
     private final String PACKAGE_KEY = "package";
-    private final String PREVIOUS_DEPLOYMENT_KEY_KEY = "previousDeploymentKey";
+    private final String PREVIOUS_RELEASE_CHANNEL_PUBLIC_ID_KEY = "previousReleaseChannelPublicId";
     private final String PREVIOUS_LABEL_OR_APP_VERSION_KEY = "previousLabelOrAppVersion";
     private final String RETRY_DEPLOYMENT_REPORT_KEY = "CODE_PUSH_RETRY_DEPLOYMENT_REPORT";
     private final String STATUS_KEY = "status";
@@ -39,10 +39,10 @@ public class CodePushTelemetryManager {
             this.clearRetryStatusReport();
             reportMap = Arguments.createMap();
             if (this.isStatusReportIdentifierCodePushLabel(previousStatusReportIdentifier)) {
-                String previousDeploymentKey = this.getDeploymentKeyFromStatusReportIdentifier(previousStatusReportIdentifier);
+                String previousReleaseChannelPublicId = this.getReleaseChannelPublicIdFromStatusReportIdentifier(previousStatusReportIdentifier);
                 String previousLabel = this.getVersionLabelFromStatusReportIdentifier(previousStatusReportIdentifier);
                 reportMap.putString(APP_VERSION_KEY, appVersion);
-                reportMap.putString(PREVIOUS_DEPLOYMENT_KEY_KEY, previousDeploymentKey);
+                reportMap.putString(PREVIOUS_RELEASE_CHANNEL_PUBLIC_ID_KEY, previousReleaseChannelPublicId);
                 reportMap.putString(PREVIOUS_LABEL_OR_APP_VERSION_KEY, previousLabel);
             } else {
                 // Previous status report was with a binary app version.
@@ -90,11 +90,11 @@ public class CodePushTelemetryManager {
                 this.clearRetryStatusReport();
                 reportMap = Arguments.createMap();
                 if (this.isStatusReportIdentifierCodePushLabel(previousStatusReportIdentifier)) {
-                    String previousDeploymentKey = this.getDeploymentKeyFromStatusReportIdentifier(previousStatusReportIdentifier);
+                    String previousReleaseChannelPublicId = this.getReleaseChannelPublicIdFromStatusReportIdentifier(previousStatusReportIdentifier);
                     String previousLabel = this.getVersionLabelFromStatusReportIdentifier(previousStatusReportIdentifier);
                     reportMap.putMap(PACKAGE_KEY, currentPackage);
                     reportMap.putString(STATUS_KEY, DEPLOYMENT_SUCCEEDED_STATUS);
-                    reportMap.putString(PREVIOUS_DEPLOYMENT_KEY_KEY, previousDeploymentKey);
+                    reportMap.putString(PREVIOUS_RELEASE_CHANNEL_PUBLIC_ID_KEY, previousReleaseChannelPublicId);
                     reportMap.putString(PREVIOUS_LABEL_OR_APP_VERSION_KEY, previousLabel);
                 } else {
                     // Previous status report was with a binary app version.
@@ -113,7 +113,7 @@ public class CodePushTelemetryManager {
         if (statusReport.hasKey(STATUS_KEY) && DEPLOYMENT_FAILED_STATUS.equals(statusReport.getString(STATUS_KEY))) {
             return;
         }
-        
+
         if (statusReport.hasKey(APP_VERSION_KEY)) {
             saveStatusReportedForIdentifier(statusReport.getString(APP_VERSION_KEY));
         } else if (statusReport.hasKey(PACKAGE_KEY)) {
@@ -131,7 +131,7 @@ public class CodePushTelemetryManager {
         mSettings.edit().remove(RETRY_DEPLOYMENT_REPORT_KEY).commit();
     }
 
-    private String getDeploymentKeyFromStatusReportIdentifier(String statusReportIdentifier) {
+    private String getReleaseChannelPublicIdFromStatusReportIdentifier(String statusReportIdentifier) {
         String[] parsedIdentifier = statusReportIdentifier.split(":");
         if (parsedIdentifier.length > 0) {
             return parsedIdentifier[0];
@@ -141,12 +141,12 @@ public class CodePushTelemetryManager {
     }
 
     private String getPackageStatusReportIdentifier(ReadableMap updatePackage) {
-        // Because deploymentKeys can be dynamically switched, we use a
-        // combination of the deploymentKey and label as the packageIdentifier.
-        String deploymentKey = CodePushUtils.tryGetString(updatePackage, DEPLOYMENT_KEY_KEY);
+        // Because release channels can be dynamically switched, we use a
+        // combination of the releaseChannelPublicId and label as the packageIdentifier.
+        String releaseChannelPublicId = CodePushUtils.tryGetString(updatePackage, RELEASE_CHANNEL_PUBLIC_ID_KEY);
         String label = CodePushUtils.tryGetString(updatePackage, LABEL_KEY);
-        if (deploymentKey != null && label != null) {
-            return deploymentKey + ":" + label;
+        if (releaseChannelPublicId != null && label != null) {
+            return releaseChannelPublicId + ":" + label;
         } else {
             return null;
         }

package/android/app/src/main/java/com/microsoft/codepush/react/CodePushUnknownException.java

@@ -1,4 +1,4 @@
-package com.microsoft.codepush.react;
+package com.appzung.codepush.react;
 
 class CodePushUnknownException extends RuntimeException {
 
@@ -9,4 +9,4 @@ class CodePushUnknownException extends RuntimeException {
     public CodePushUnknownException(String message) {
         super(message);
     }
-}
+}

package/android/app/src/main/java/com/microsoft/codepush/react/CodePushUpdateManager.java

@@ -1,4 +1,4 @@
-package com.microsoft.codepush.react;
+package com.appzung.codepush.react;
 
 import android.os.Build;
 

package/android/app/src/main/java/com/microsoft/codepush/react/CodePushUpdateState.java

@@ -1,4 +1,4 @@
-package com.microsoft.codepush.react;
+package com.appzung.codepush.react;
 
 public enum CodePushUpdateState {
     RUNNING(0),
@@ -12,4 +12,4 @@ public enum CodePushUpdateState {
     public int getValue() {
         return this.value;
     }
-}
+}

package/android/app/src/main/java/com/microsoft/codepush/react/CodePushUpdateUtils.java

@@ -1,4 +1,4 @@
-package com.microsoft.codepush.react;
+package com.appzung.codepush.react;
 
 import android.content.Context;
 import android.util.Base64;

package/android/app/src/main/java/com/microsoft/codepush/react/CodePushUtils.java

@@ -1,4 +1,4 @@
-package com.microsoft.codepush.react;
+package com.appzung.codepush.react;
 
 import android.util.Log;
 

package/android/app/src/main/java/com/microsoft/codepush/react/DownloadProgress.java

@@ -1,4 +1,4 @@
-package com.microsoft.codepush.react;
+package com.appzung.codepush.react;
 
 import com.facebook.react.bridge.WritableMap;
 import com.facebook.react.bridge.WritableNativeMap;

package/android/app/src/main/java/com/microsoft/codepush/react/DownloadProgressCallback.java

@@ -1,4 +1,4 @@
-package com.microsoft.codepush.react;
+package com.appzung.codepush.react;
 
 interface DownloadProgressCallback {
     void call(DownloadProgress downloadProgress);

package/android/app/src/main/java/com/microsoft/codepush/react/FileUtils.java

@@ -1,4 +1,4 @@
-package com.microsoft.codepush.react;
+package com.appzung.codepush.react;
 
 import java.io.BufferedInputStream;
 import java.io.BufferedReader;

package/android/app/src/main/java/com/microsoft/codepush/react/ReactInstanceHolder.java

@@ -1,4 +1,4 @@
-package com.microsoft.codepush.react;
+package com.appzung.codepush.react;
 
 import com.facebook.react.ReactInstanceManager;
 

package/android/app/src/main/java/com/microsoft/codepush/react/SettingsManager.java

@@ -1,4 +1,4 @@
-package com.microsoft.codepush.react;
+package com.appzung.codepush.react;
 
 import android.content.Context;
 import android.content.SharedPreferences;

package/android/app/src/main/java/com/microsoft/codepush/react/TLSSocketFactory.java

@@ -1,4 +1,4 @@
-package com.microsoft.codepush.react;
+package com.appzung.codepush.react;
 
 import java.io.IOException;
 import java.net.InetAddress;

package/android/build.gradle

@@ -15,7 +15,7 @@ buildscript {
 
 allprojects {
     android {
-        namespace "com.microsoft.codepush.react"
+        namespace "com.appzung.codepush.react"
     }
     repositories {
         mavenLocal()

package/android/codepush.gradle

@@ -69,9 +69,9 @@ gradle.projectsEvaluated {
 
         def nodeModulesPath;
         if (project.hasProperty('nodeModulesPath')) {
-            nodeModulesPath = "${project.nodeModulesPath}/react-native-code-push"
+            nodeModulesPath = "${project.nodeModulesPath}/@appzung/react-native-code-push"
         } else {
-            nodeModulesPath = findNodeModulePath(projectDir, "react-native-code-push")
+            nodeModulesPath = findNodeModulePath(projectDir, "@appzung/react-native-code-push")
         }
 
         def targetName = variant.name.capitalize()
@@ -95,7 +95,7 @@ gradle.projectsEvaluated {
 
             // mitigates Resource and asset merger: Duplicate resources error
             project.delete(files("${jsBundleDir}"))
-            
+
             jsBundleDir.mkdirs()
             resourcesDir.mkdirs()
 

package/docs/advanced-usage.md

@@ -0,0 +1,56 @@
+## Advanced usage
+
+### Multiple environments
+
+#### Staging / Production
+
+In a real-world scenario you would have `Staging` and `Production` apps that are different binaries, each using specific environment config (different package name, bundle identifier, API, feature flags etc). Create a release channel for each of these environments with `appzung release-channels create` and change the `CodePushReleaseChannelPublicId` on the native side with environment variables. You might want to use a module like [react-native-config](https://github.com/lugg/react-native-config) (or do it manually using build variants and configurations).
+
+```groovy
+// android/app/build.gradle
+android {
+    // ...
+    defaultConfig {
+        // ...
+        resValue 'string', "CodePushReleaseChannelPublicId", project.env.get("CODEPUSH_RELEASE_CHANNEL_PUBLIC_ID_ANDROID")
+    }
+}
+```
+
+```
+// ios/myapp/Info.plist
+
+<key>CodePushReleaseChannelPublicId</key>
+<string>$(CODEPUSH_RELEASE_CHANNEL_PUBLIC_ID_IOS)</string>
+```
+
+#### QA / Production
+
+In the case where you have a `QA` environment that is completely iso-prod (meaning you can swap the JS bundle between those two apps), you may take advantage of the `promote` feature:
+
+1. Release a CodePush update to your `QA` release channel using the `appzung releases deploy-react-native` command (or `appzung releases deploy` if you need more control)
+2. Let QA test the build
+3. Promote the tested release from `QA` to `Production` using the `appzung releases promote` command
+
+*NOTE: If you want to take a more cautious approach, you can even choose to perform a "staged rollout" as part of #3, which allows you to mitigate additional potential risk with the update (like did your testing in #2 touch all possible devices/conditions?) by only making the production update available to a percentage of your users (for example `appzung releases promote -r 20`). Then, after waiting for a reasonable amount of time to see if any crash reports or customer feedback comes in, you can expand it to your entire audience by running `appzung releases edit -r 100`.*
+
+### Dynamic release channel assignment
+
+The above section illustrated how you can leverage multiple CodePush release channels in order to effectively test your updates before broadly releasing them to your end users. However, since that workflow statically embeds the release channel assignment into the actual binary, a staging or production build will only ever sync updates from that release channel. In many cases, this is sufficient, since you only want your team, customers, stakeholders, etc. to sync with your pre-production releases, and therefore, only they need a build that knows how to sync with staging. However, if you want to be able to perform A/B tests, or provide early access of your app to certain users, it can prove very useful to be able to dynamically place specific users (or audiences) into specific release channels at runtime.
+
+In order to achieve this kind of workflow, all you need to do is specify the release channel public ID you want the current user to synchronize with when calling the `codePush` method. When specified, this key will override the "default" one that was provided in your app's `Info.plist` (iOS) or strings resources (Android) files. This allows you to produce a build for staging or production, that is also capable of being dynamically "redirected" as needed.
+
+```javascript
+// Imagine that "userProfile" is a prop that this component received
+// which includes the release channel public ID that the current user should use.
+codePush.sync({ releaseChannelPublicId: userProfile.RELEASE_CHANNEL_PUBLIC_ID });
+```
+
+With that change in place, now it's just a matter of choosing how your app determines the right release channel for the current user. In practice, there are typically two solutions for this:
+
+1. Expose a user-visible mechanism for changing release channels at any time. For example, your settings page could have a toggle for enabling "beta" access. This model works well if you're not concerned with the privacy of your pre-production updates, and you have power users that may want to opt-in to earlier (and potentially buggy) updates at their own will (kind of like Chrome channels). However, this solution puts the decision in the hands of your users, which doesn't help you perform A/B tests transparently.
+2. Annotate the server-side profile of your users with an additional piece of metadata that indicates the release channel they should sync with. By default, your app could just use the binary-embedded key, but after a user has authenticated, your server can choose to "redirect" them to a different release channel, which allows you to incrementally place certain users or groups in different release channels as needed. You could even choose to store the server-response in local storage so that it becomes the new default. How you store the key alongside your user's profiles is entirely up to your authentication solution (for example Auth0, Firebase, custom DB + REST API), but is generally pretty trivial to do.
+
+*NOTE: If needed, you could also implement a hybrid solution that allowed your end-users to toggle between different release channels, while also allowing your server to override that decision. This way, you have a hierarchy of "release channel resolution" that ensures your app has the ability to update itself out-of-the-box, your end users can feel rewarded by getting early access to bits, but you also have the ability to run A/B tests on your users as needed.*
+
+Are you using dynamic release channel assignments? Contact us at hello@appzung.com so that we may provide better integration.