Note: Zoho Creator's Mobile SDK is currently a Beta feature. We do not recommend using it for apps in the production stage

We have created an application using our SDK for your better understanding of the different methods and their usage.

1. Prerequisites

• The latest version of Android Studio.
• A Zoho account. If you do not have an account, sign up for one here.

2. Register your Android app with Zoho

2.1 Users in Creator 5, follow the below steps:

1. Visit Zoho’s Developer Console.
2. On the API Credentials page, click the Add Client ID button. The Create Zoho Client ID form will appear.
3. In this form, enter the following details:
   
   • Client Name: Name of your app
   • Client Domain: Website of your app
   • Authorized redirect URIs: Redirect URI for authentication. The URI must be entered in the :// format; for example,
     
     myappsdk://
     (The URL is case-sensitive).
     
4. In the Client Type drop-down list, choose Mobile.
5. Click the Create button. The Client ID and Client Secret will be displayed.

2.2 Users in Creator 6, follow the below steps:

1. Click Mobile from the left pane and select the SDK pane.
   

   

2. Click on the required row of the iOS app for which you want to configure the core framework. The  For User - SDK pane will open on the right. 
   

   

3. Click  Generate Client. This will generate the client ID and client secret for the Android app that you want to integrate with your Creator application.
   

   

4. Downloaded the  zcapp_info.properties file, then add it to your project's  raw folder:  "<your_project_folder>/app/src/main/res/raw". (Create a folder named  raw in this location if it doesn't exist)
   

   

3. Create a Zoho Creator application

1. Download this file, then extract its contents. A folder named ZohoCreatorAndroidSDKDemo will be extracted.
2. Access the folder. It will contain a Utility.ds file (which contains the definition of a sample Creator application).
3. Go to your Creator Home.
4. Click the Import a File button near the top-right corner.
5. Select Local storage, then upload the Utility.ds file you extracted in step one. You'll be redirected to the Utility application.

4. Install the Android SDK

1. Open Android Studio and choose Import Project.
2. In the Import Project dialog, select the Utility folder available in the file you downloaded in the previous section.
3. Open the  zcapp_info.properties in the  app/src/main/res/raw folder and replace the following parameters:
   
   AppOwnerName=<Demo App Owner Name>
   AppLinkName=<Demo App Link Name>
   CreatorDomain=creator.zoho.com
   AccountsDomain=accounts.zoho.com
4. Open the  strings.xml file and replace the following parameters:
   

   <string name="c_id"> YOUR CLIENT ID </string>
   <string name="c_secret"> YOUR CLIENT SECRET </string>
   <string name="redir_url"> REGISTERED REDIRECTURI </string>
   <string name="accounts_url">https://accounts.zoho.com</string>  <!--enter the accounts URL of your respective DC. For eg: EU users use https://accounts.zoho.eu-->
   <string name="redir_url_for_manifest">REDIRECT URI WITHOUT COLON AND SLASH</string>

5. Run the project on emulator / device.