Skip to content

Latest commit

 

History

History
62 lines (54 loc) · 3.2 KB

README.md

File metadata and controls

62 lines (54 loc) · 3.2 KB
Raw

PortableShop - MAUI

Summary

Working portable application for test and demo purpose. It simulates limited shopping capabilities based on the Microsoft AdventureWorks database. This project is the active continuation from Xamarin Forms. Its version will continue from 2.0.

Purpose

  • Explore coding techniques based on MAUI, XAML and C#.
  • Explore continuous integration by using combination of Git, GitHub, and Azure DevOps.

Context

  • This is the MAUI-conversion of my PortableShop - Xamarin Forms
  • This is a near equivalent of my WpfShop.
  • Currently the Android application is only tested on API 30.
  • Currently the Windows application is only tested on Windows 10 version 22H2.
  • Connected to Azure Devops self hosted build pipeline. Current build status for master branch:
  • Azure DevOps release pipeline to GitHub.
  • See Release Notes for the latest developments.

Project aspects

  • MAUI + MAUI Community Toolkit.
  • .Net 7 + .Net Standard 2.0.
  • XAML + C#.
  • MVVM.
  • Dependency injection.
  • Client-server + SSL.
  • Asynchronicity.
  • Dataservice by Web API, CoreWcf, or WCF.
  • Error handling.
  • Globalized resources.
  • Basic styling.
  • Splash screen.
  • Shell navigation including Fly out.
  • Rotation.
  • Custom controls.
  • Extensions.
  • Attached behaviours.
  • Application icon (Android).
  • MSIX installation.

Prerequisites

Installation

  • The application is plug & play, but use of the data service is on request. Contact the developer ahead.
  • Installables are to be obtained from Assets of the latest available release in Releases.
  • Also note the accompanying or latest release notes.
Android
  • Download the latest APK file to your Android phone.
  • Install the aplication from the notification or the download folder. You probably have to suppress some warnings.
  • In some cases one needs to 'Uninstall for all users' and repeat the install.
  • Start the application. Either it will start 'empty' displaying a warning, or if the data service is running, one can 'shop' the contents.
  • Uninstallation can be done by the normal Android procedure.
  • Updating is currently not supported, but can be done manually after uninstalling. One can use the option from the application's menu to get to the Release page.
Windows
  • Download the latest ZIP file to your PC.
  • Extract if needed.
  • If not already done, install the certificate by right clicking on the .cer file. Choose 'Local Machine' and select 'Trusted Root Certification Authorities' as store.
  • Now install the application by double clicking the .msix or .msixbundle file. If selected, the application starts right away.
  • Note that the application gets installed in the Windows 'Apps' menu, and will not show up in the 'Programs and Features' list.
  • Both starting (left click) and uninstallation (right click) are from the 'Apps' menu.