NV.Templates.Mobile 0.75.1

Uno Platform Application Template

This is a mobile app project template using Uno Platform and the latest .NET practices.

• It uses the MVVM pattern.
• Code is organized by application layer.
• It comes with dependency injection.
• There are built-in logs and diagnostics tools.
• There is scaffolding code showing sample features. When you run as-is, you get a Dad Jokes application.

Requirements

This template largely relies on Uno Platform, if you want to make sure you got everything installed correctly on your machine, we encourage you to use uno-check, the documentation is available here

In addition to that, Visual Studio 2022 with .Net 7 are required.

Getting Started

We use dotnet project templates to easily create new projects. It simplifies the project renaming and supports conditional inclusions.

Installing the template

1. In order to install the template, clone this repository on your machine, open a command prompt at its root and run the following command.

   • dotnet new install ./

   This will display a list of installed templates, look for this template and copy the command with the absolute path like this.

   • dotnet new list

Read this for more information on custom templates.

Running the template to generate a new project

1. To run the template and create a new project, run the following command in the root folder that will contain the new project.

   dotnet new nv-mobile -n MyProjectName

   The following options are available when running the command.

   • To get help: dotnet new nv-mobile -h

   ⚠️ The use of periods (.) in the project name is not supported and may result in building issues.

Next Steps

1. Open the solution file from the generated folder using Visual Studio.

   It's located at MyProjectName/src/MyProjectName.sln.

2. In Visual Studio, go to the VIEW menu and open the Task List to get hints on next steps.

   This template comes with several pointers on what you're most likely to change next.

Uninstalling the template

1. If you want to uninstall the template, open a command prompt at its root and run the following command.

   • dotnet new uninstall ./

Documentation

This repository provides documentation on different topics under the doc folder.

• Architecture
• Dependency Injection
• Configuration
• HTTP
• Logging
• Diagnostics
• Platform specifics
• Serialization
• Startup
• Testing
• Environments
• Localization
• Validation
• Error handling
• Scheduling
• Reviews (app star ratings)

Changelog

Please consult the CHANGELOG for more information about the version history.

License

This project is licensed under the Apache 2.0 license. See the LICENSE for details.

Contributing

Please read CONTRIBUTING for details on the process for contributing to this project.

Be mindful of our Code of Conduct.