tutorial_mobile.md

copyright	years 2016, 2017
lastupdated	2017-10-02

{:new_window: target="_blank"} {:shortdesc: .shortdesc} {:screen: .screen} {:codeblock: .codeblock} {:pre: .pre}

Mobile Basic Starter

{: #tutorial}

The following end-to-end tutorial walks you through the steps to create a mobile project from a Mobile Basic Starter. This guide includes installing prerequisite tools, and the steps to run the project in Xcode and Android Studio.

Installing developer tools

{: #dev_tools}

Ensure that you install the prerequisite developer tools {: new_window}.

Choose how to create your project

{: #choose_how}

You can create a project by using either the web-based {{site.data.keyword.dev_console}} or through the command-driven {{site.data.keyword.dev_cli_notm}}.

Creating a project by using the {{site.data.keyword.dev_console}}

{: #create-devex}

1. Create a {{site.data.keyword.dev_console}} project in {{site.data.keyword.Bluemix}}.

   1. From the Starter Kits page in the {{site.data.keyword.dev_console}}, select a Starter Kit based on your chosen capabilities. For example, for a Watson Language application, go to Watson Language and click Select Starter Kit.

   2. Enter your project name. For this tutorial, use WatsonProject.

   3. Select your language platform. For this tutorial, use Swift.

   4. Click Create Project.

Optional: Add services

{: #add-services}

1. Select your project in the Projects page.

2. Click Add Service.

3. Select the kind of service you want. For this tutorial, select Security > Next > App ID > Next.

4. Enter your service name and click Create.

5. For more information about configuring Authentication, see Configuring identity providers {: new_window}.

6. For more information about configuring Analytics, see Getting started with {{site.data.keyword.mobileanalytics_short}} {: new_window}.

7. For more information about configuring {{site.data.keyword.cloudant_short_notm}}, see Getting started with {{site.data.keyword.cloudant_short_notm}} {: new_window}.

8. For more information about configuring {{site.data.keyword.objectstorageshort}}, see Getting started with {{site.data.keyword.objectstorageshort}} {: new_window}.

9. For more information about adding the Push Notifications capability, see:

   1. For iOS, configure Apple Push Notification Service {: new_window}.

   2. For Android, configure Firebase Cloud Messaging {: new_window}.

Generate your project code

{: #generate-code}

1. Select your project in the Projects page.

2. Click Download Code to download your project archive.

Begin working on your app

{: #code}

Begin working with your downloaded project:

1. Expand the archived file.

2. Navigate to the new project directory.

3. Use the {{site.data.keyword.dev_cli_notm}} to proceed.

Creating a project by using the {{site.data.keyword.dev_cli_notm}}

{: #create-cli}

1. Ensure that you install the {{site.data.keyword.dev_cli_short}}.

2. In your Terminal prompt, navigate to a local directory of your choice and run the following command.

   bx dev create
   

   {: codeblock}

3. Provide the following values when prompted:

   • Select a pattern: 2 (for Mobile)
   • Select a starter: 1 (for Basic)
   • Select a platform: 3 (for iOS Swift)
   • Enter a name for your project: MobileBasicProjectCLI

4. If you want to add services to your project, type y at the question prompt and answer the remaining questions.

5. When your MobileBasicProjectCLI is successfully saved, navigate to the MobileBasicProjectCLI/MobileBasicProjectCLI-Swift folder.

Running your Swift project in Xcode

{: #run_swift}

1. Extract the MobileBasicProject-Swift.zip file.

2. Open the README.md file in a Markdown viewer to review the steps to configure your project.

   1. Open your Terminal and navigate to your project folder.

      1. Run pod setup if you need to set up your CocoaPods repository.

      2. Run pod update if you need to update you update your existing pods.

      3. Run pod install to install the pods for your project.

   2. Open your BasicProject.xcworkspace Xcode workspace.

3. Run your app.

Running your Cordova project in Xcode

{: #run_cordova_xcode}

1. Extract the MobileBasicProject-Cordova.zip file.

2. Open the README.md file in a Markdown viewer to configure your project.

   1. Open your platforms/ios project in Xcode.

3. Run your app.

Running your Cordova project in Android Studio

{: #run_cordova_studio}

1. Extract the BasicProject-Cordova.zip file.

2. Open the README.md file in a Markdown viewer to configure your project.

   1. Open your platforms/android project in Android Studio.

3. Run your app.

Running your Android project in Android Studio

{: #run_android}

1. Extract the MobileBasicProject-Android.zip file.

2. Open the README.md file in a Markdown viewer to configure your project.

   1. Open your BasicProject-Android project in Android Studio.

3. Run your app.