eShopOnContainers is a reference app whose imagined purpose is to serve the mobile workforce of a fictitious company that sells products. The app allow to manage the catalog, view products, manage the basket and the orders.
eShopOnContainers is a reference app whose imagined purpose is to serve the mobile workforce of a fictitious company that sells products. The app would allow a user to manage their catalog, view products, manage the basket/cart and the orders.
1. A Xamarin.Forms mobile app for iOS, Android and Windows.
2. Several .NET Web API microservices deployed as Docker containers.
@ -22,7 +22,7 @@ This project exercises the following platforms, frameworks or features:
* Central Styles
* Custom Renderers
* Animations
* IoC
* IoC (Inversion of Control)
* Messaging Center
* Custom Controls
* Cross Plugins
@ -40,10 +40,10 @@ The app targets **three** platforms:
* iOS
* Android
* Universal Windows Platform (UWP)
* UWP supported only in Visual Studio, not Xamarin Studio or Visual Studio for MacOS
* UWP is supported only in Visual Studio, not Xamarin Studio or Visual Studio for MacOS
As of 07/03/2017, eShopOnContainers features **89.2% code share** (7.2% iOS / 16.7% Android / 8.7% Windows).
As of 07/03/2017, eShopOnContainers features **89.2% code sharing** (7.2% iOS / 16.7% Android / 8.7% Windows).
## Licenses
@ -58,7 +58,7 @@ This project uses some third-party assets with a license that requires attributi
## Requirements
### Requirements for March 2017 version of eShopOnContainers
* [Visual Studio __2015__](https://www.visualstudio.com/en-us/products/vs-2015-product-editions.aspx) (14.0 or higher) to compile C# 6 langage features (or Visual Studio MacOS)
* [Visual Studio __2015__](https://www.visualstudio.com/en-us/products/vs-2015-product-editions.aspx) (14.0 or higher) to compile C# 6 language features (or Visual Studio for MacOS)
* Xamarin add-ons for Visual Studio (available via the Visual Studio installer)
* __Visual Studio Community Edition is fully supported!__
* [Android SDK Tools](https://developer.xamarin.com/guides/android/getting_started/installation/windows/) 25.2.3 or higher
@ -68,23 +68,23 @@ This project uses some third-party assets with a license that requires attributi
#### [1. Ensure the Xamarin platform is installed](http://developer.xamarin.com/guides/cross-platform/getting_started/installation/)
#### 2. Ensure Xamarin are updated
#### 2. Ensure Xamarin is updated
Xamarin will periodically automatically check for updates. You can also manually check for updates.
<imgsrc="Images/Updates.png"alt="Ensure Xamarin are updated"Width="600"/>
<imgsrc="Images/Updates.png"alt="Ensure Xamarin is updated"Width="600"/>
### 3. Project Setup
Restore NuGet packages for the project.
### 4. Ensure Android Emulator is installed
You can use any Android emulator although it is highly recommended to use an x86 based version.
You can use any Android emulator, although it is highly recommended to use an x86 based version.
<imgsrc="Images/AndroidEmulator.png"alt="Visual Studio Android Emulator"Width="600"/>
**Note**: The Visual Studio Android Emulator cannot run well inside a virtual machine or over Remote Desktop or VNC since it relies on virtualization and OpenGL.
**Note**: The Visual Studio Android Emulator cannot run well inside a Virtual Machine or over Remote Desktop or VNC since it relies on virtualization and OpenGL.
To deploy and debug the application on a physical device, refer to these [link](https://developer.xamarin.com/guides/android/deployment,_testing,_and_metrics/debug-on-device/).
To deploy and debug the application on a physical device, refer to this [link](https://developer.xamarin.com/guides/android/deployment,_testing,_and_metrics/debug-on-device/).
### 5. Ensure Mac connection
To set up the Mac host, you must enable communication between the Xamarin extension for Visual Studio and your Mac.
@ -97,7 +97,7 @@ The app has the following screens:
* a auth screen
* a catalog list
* a profile section with a order list
* a profile section with an orders list
* a readonly order detail screen
* a customizable basket
* a checkout screen
@ -117,22 +117,22 @@ If you see build issues when pulling updates from the repo, try cleaning and reb
**Unsupported major.minor version 52.0**
So, you just downloaded the source code and ready to build the application and...
So, you just downloaded the source code and you are ready to build the application and...
<imgsrc="Images/Unsupported52.0.png"alt="Unsupported major.minor version 52.0"Width="600"/>
We have two possible fixes.
The first one is based on updating Java JDK and ensure its use. The version 52.0 referenced in the error refers to the JDK, specifically to version 8. Xamarin Android 7.0 requires the JDK 1.8 to use the Android Nougat APIs (API Level 24). It is also necessary a 64-bit version to be able to use personal controls in the Android editor among other actions.
The first one is based on updating Java JDK and ensure it's being used. The version 52.0 referenced in the error refers to the JDK, specifically to version 8. Xamarin Android 7.0 requires the JDK 1.8 to use the Android Nougat APIs (API Level 24). It is also necessary for a 64-bit version to be able to use personal controls in the Android editor among other actions.
Download the corresponding version of the JDK in this [link](http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html).
Download the corresponding version of the JDK from this [link](http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html).
After downloading and installing, we must ensure that the installed version is used. For that:
Cesar De la Torre
7 years ago
GitHub