Ionic Deploy is a tool that enables you and your team to send live code changes directly to your users, when you’re ready, without waiting in line for App Store reviews and approvals.
This article covers the following questions:
- What is the definition of a "Live Update"?
- Do downloads from the app store count agains the live deploy limit?
- What happens when live deploys are depleted for the month?
What is the definition of a "Live Update"?
One “live update” is one update that is applied to a physical device. Think of “live updates” as just “updates downloaded.” If 1 new version of code is downloaded by 1000 phones, that’s 1000 live updates. If 2 new versions of code get downloaded by 1000 phones, that’s 2000 live updates.
Phones also have the ability to keep old versions of code around (this is defaulted to 2) using the MAX_STORE parameter during installation of the Ionic Cordova plugin. If you revert to a previous version of code and a phone already has it downloaded, that will not count as a live update.
Do downloads from the app store count against the live deploy limit?
Ionic Pro and the Deploy service (and our Deploy Limits) never limit or change how often you can manually update the App Stores with new native binaries. We don’t handle or limit this process for you, and you can do it unlimited times.
However, you’ll want to make sure that new installs from the App Store don’t automatically download Deploys from us. In order to do this, make sure when you upload a new native binary to the App Stores that you set the “Equivalent” native versioning to the native version you deployed to the app store for iOS and Android. You can do this by clicking on the build hash in your dashboard and clicking on the “Native Versioning” tab.
If you do NOT set up Equivalent native versioning, whenever someone downloads your app from the App Store, if you have an active commit on the Channel that app is pulling from, it WILL count as a Live Update because an update is being downloaded from our server.
What happens when live deploys are depleted for the month?
First of all, it’s important to note that your quota is for a Calendar month (January, February, etc) and not your billing period.
When you use all of your live update quota for the month, users will no longer be able to download new versions of your app to their devices. This means if you run out in the middle of an update, half of your users might wind up on an older version of your code if you don’t have any quota left. Users left on older versions of your code will still function correctly on that version of code.
When limits start to be enforced during the month of April 2018, you will receive three emails from Ionic about your Deploy Limits:
- An email when you hit 70% of your quota
- An email when you hit your quota telling you to upgrade
- A final email warning you that we’re going to turn off your Deploy service until the next billing cycle if you haven’t upgraded your Ionic Pro plan after a grace period of live update usage.
When the 1st of the next month rolls around, you’ll be able to use Deploy again, and live update rollouts that didn’t finish will continue to rollout to users that didn’t receive the update.