Migration Guide

Ionic Cloud has been deprecated. To continue using Ionic services, migrate to Ionic Pro before Jan. 31, 2018.

This is a migration guide for existing Ionic 1 apps to migrate from the deprecated ionic-platform-web-client to the Cloud Client.

You are currently viewing the Ionic 2 version of the docs. Use the framework switcher on the nav bar to switch to Ionic 1.

Before anything, make sure you’re using the latest CLI (2.x) npm update --save ionic.


First, let’s remove the existing install of ionic-platform-web-client.

Now you can do a fresh install and setup the Cloud Client.



Minor stuff


In an attempt to make things much easier for the majority of developers, some breaking changes were made for Ionic User. Instead of having a single User class that has everything, we’ve enforced a single reference to the active user and made it seem more like a model. The User class uses a service class underneath the hood that manages the single reference, making it easier on you.

Removed Methods

The load(id), save(), and delete() methods all exist on $ionicUser and all update the $ionicUser reference. They no longer resolve with a new user in the success handler.



Minor stuff


Because we switched to using standard Promise objects, the progress notification must be done a way other than a third callback of the then function. $ionicDeploy.download() and $ionicDeploy.extract() take an option for an onProgress callback. See the docs. </div>