On your MacBook, open the iOS Assistant and click Create New to start the creation workflow.
The initial step of the workflow asks you to choose whether to create a sample app, use an existing cloud app configuration, or create a new one.
Click the Reuse Existing Application tile in the middle of the Create a new App step. This will allow us to use the previously defined cloud app configuration.
The first step in the Reuse Existing Application workflow wants you to select the Mobile Services account you want to use. You could have multiple accounts here for different landscapes you might use.
Select your account and click on Next.
Step 2 lets you select the Cloud Application you want to base your Xcode iOS project on.
Select the com.example.tutorialapp
and click on Next.
If you look closely at the UI you can see a clear distinction between the Cloud Configuration and the Client Configuration. So right now you’re transitioning into the definition of your Xcode project and the way the iOS Assistant generates your app.
Fill in the fields as seen in the following table:
Field |
Value |
Product Name |
TutorialApp |
Organization Name |
Fill in your org name |
Organization Identifier |
com.sap.example |
Note: The name of the cloud application does not need to match your iOS app name, and often won’t; your iOS app may access multiple cloud applications. The Application Identifier, however, must be unique across all of your configured cloud applications, and typically follows a reverse-DNS format.
Choose a path where to save the project to and click Next to advance to the Proxy Classes step.
Here you can see what destination is going to be used to pull the Metadata of the OData Service to generate the OData Proxy Classes. If you hover over the displayed service identifier you can make changes to the way the iOS Assistant generates these classes. You won’t touch this feature in most of the tutorials.
Click Next to go to the UI Configuration step.
The UI Configuration step will let you define what the iOS Assistant should generate on top of the Proxy Classes and convenience data service. For most tutorials, you will replace the generated UI with your own but to get an understanding of the iOS Assistant’s power, make sure all the checkboxes are selected and click on Finish.
The iOS Assistant will now connect to Mobile Services and fetches the defined configuration and the Metadata document of the sample service. With that information, it will create an Xcode project for you including the selected UI, Proxy Classes which will represent the entities in the service, as well as a convenience data service for easy backend communication.
Your Xcode project should automatically open up and you can run the app.