iOS/Android Xamarin Mobile App

The package you get contains 3 items. Two plugins for GrandNode and a solution for Xamarin (.NET Standard 2.0).
 
Xamarin solution.

 
Both plugins, Grand.Plugin.Misc.Mobile and Grand.Plugin.Misc.MobileCart needs to be compiled and installed at the GrandNode store. The first plugin is used to exchange data between store and app, the second one is used for the checkout process. 



Steps you need to follow in order to rebrand the default app:

Xamarin Shared project:

At Services/Settings/AppSettings.cs may find AppSettings class, replace settings with your domain, except CurrentVersion. CurrentVersion needs to be the same as set in the plugin (by default is already done, if change sources of the plugin need to update here as well). 


GrandNode plugin configuration  

At the configuration of the GrandNode plugin, you may add additional parameters.


Topics

At GrandNode are two Pages that used to be displayed at the mobile app: MobileHomePage and MobileNewsPage.

MobileHomePage used for displaying home page text, like promo banner at our sample app

MobileNewsPage is used for displaying news on the mobile app. 

Your custom navigation
<p><!--Some rules to follow while using custom navigation-->
<!--myNavigation;Product;productId;productName for displaying single product page-->
<!--myNavigation;ProductList;categoryId;categoryName for displaying list of products, id stands for ParentCategoryId of each product-->
<!--myNavigation;Category;categoryId;categoryName for displaying category list-->
<!--myNaviagtion;Manufacturer;manufacturerId;manufacturerName for displaying products list from given manufacturer--></p>
<p><a href="myNavigation;Product;1;HADES Gaming Keyboard">Product: HADES Gaming Keyboard</a></p>
<p><a href="myNavigation;ProductList;1;Accessories">Category products: Accessories</a></p>
<p><a href="myNavigation;Category;1;Gift cards">Categories: Gift vouchers</a></p>
<p><a href="myNavigation;Manufacturer;1;Apple">Manufacturer products: Apple</a></p>

Steps to publish app to the stores

Steps you need to follow in order to publish your app to App Store, after making sure you already did everything described in "Rebrand" section:

1. Go to Apple Developer Account -> Certificates, Identifiers and Profiles and create two new iOS certificates, one for Distribution and one for iOS Development. In the meantime you will be instructed to supply Certificate Signing Requests file and how to create this .csr file is also written there. After creating the certificates, download them and double tap .cer files to install them.

2. In Apple Developer Account, go to App IDs and create new one, ideally wildcard if you want to publish multiple apps in the future, so something like com.newapp.*

3. In Apple Developer Account, go to Provisioning Profiles and create one for Development and one for Distribution, selecting Certificate and App ID you prevoiusly set up. Good practice is to include type of profile (dist/dev) and dates in their names, so that after they expire and you will have to create new ones you won't be confused. If selecting your device will be required in one of the steps, you will have to set it up in Devices section. After creating the provisioning profiles download them and double tap to install.

4. Go to Itunes Connect, My Apps and create new iOS App.

5. After that your apple accounts are set, go to Visual Studio and connect to Mac (plenty of instruction on the Web).

6. Right click on Xamarin.iOS native project and go to properties, then to iOS Bundle Signing. Provisioning profiles should be automatically downloaded from your Mac. If they are not set corretly by default, set them manually.

7. Rebuild your app, select Ad-Hoc and iPhone in build configurations. After its done (it might take a while), move .ipa file to your mac and upload it with Application Loader.

8. After that, everything is self explanatory, you just have to fill in App information in ITunes Connect, add screenshots and select your uploaded build and you are ready to submit your app to Apple Review. Once Apple Review accepts your app, it will be visible in App Store.

 

Shopping cart is empty after checkout button

This issue is related to the basic store configuration. It may happen mostly when you didn't configure an SSL connection in your store correctly. If the behavior described below is similar to your case, follow the article, at the end we will show you how to fix it.

If your customers have products in the shopping cart and after pressing the Checkout button in the mobile app cart, the application will notify them that the shopping cart is empty, which means that you should check your store configuration.

Solution

Please make sure that your store configuration doesn't have common mistakes, like wrong store URL in Configuration -> Store settings or what's mentioned at the beginning - check both URL addresses - Store URL and URL in the mobile app configuration are the same.