5 Client and App Profile Lifecycle
If your mobile app uses push notifications or you want to use analytics to examine and improve your app, you need a client. You associate the client, which represents a backend binary, with a backend. Use profiles to store notification credentials that can be shared between your clients. Clients go through similar lifecycle phases as other artifacts with a few differences, detailed in this chapter.
AMCe can help you manage client lifecycle. You can publish and export a client. You can modify its version number and move it to the trash when you don’t need it anymore. Clients are top-level artifacts and their relationships with backends can affect how both types of artifacts are exported, imported, and moved to the trash.
If you want a general introduction to how artifacts interrelate in the overall lifecycle, see Understanding Lifecycles.
Publishing a Client
Updating the Version Number of a Client
Creating a New Version of a Client
Another reason for creating new versions is to create multiple clients for the same platform if there are multiple mobile app binaries for the same platform that use the same backend.
Note:
Unlike other artifacts, which require that the version number use the Major.minor format, the version number for a client should be the same as the mobile app binary that’s set by the app store. Depending on the version of the mobile app binary, the version could take the format of Major.minor or include an alphanumeric suffix with or without parentheses, a hyphen, space, or full stop. For example:-
1.2
-
1.2 build 3452
-
1.2 (3452)
-
1.2–3452
-
1.2.3 (01–Jun-2016)
- Click and select Mobile Apps > App Profiles from the side menu.
- Select the client and then select More > New Version.
- Enter a version number in the Mobile App Version field. (The same as the mobile app binary set by the app store.)
- Click Save.
Moving a Client to the Trash
Note:
Moving a client to the trash does not move the associated backend or any profiles referenced by the client to the trash.Restoring a Client
- Click and select Mobile Apps > App Profiles from the side menu.
- Click Trash ().
- In the list of items in the trash, select the client and select Restore from Trash.
- Click Restore in the confirmation dialog if there are no conflicts.
Managing Your Clients and App Profiles
When at least one client or app profile exists, you'll be taken to the Clients page every time you click and select Mobile Apps > App Profiles from the side menu. On the left side of the page, you see a list of all the clients, their version numbers, and their Draft or Published state (clients in the trash aren't displayed).
On the Clients page, you can open, test, publish, and view see the dependencies and history for your clients:
-
Click Open to see details about the selected client.
-
Click Publish to change the state of the client.
-
Click More to create a new version, export the client to another instance, or move the client to the trash.
-
Click Trash ( ) to see which clients are in the trash.
-
Expand Keys to obtain the values for the client ID and the application key.
-
Expand Notifications to see which push notifications, if any, are enabled for this app profile.
On the lower right side of the page, you can view data about the selected client:
-
Expand Dependencies to see the backend and app profile that this client references.
Note:
If the backend has downstream dependencies, go to Mobile Apps > Backends and view them from the Dependencies section of the selected backend. -
Expand History to quickly see the latest activity for the client.
Click the Profiles tab to view available app profiles and create new app profiles for your clients.