SuavePirate / Xamarin.Onion

Templates for Xamarin / C# projects that use a scalable Onion Architecture

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Xamarin.Onion

Templates for Xamarin / C# projects that use a scalable Onion Architecture. These templates make use of Separation of Concerns, Model View ViewModel, Inversion of Control, and Dependency Injection. There is an assumption that the user of these templates has an understanding of these concepts at a high level.

Source

This is where the solution and projects exist for the templates

Templates

This is where the actual Visual Studio Templates exist

Using the templates

  1. Download or Pull the repo
  2. Copy each of the desired template .zip files from Templates that you want to have in VS
  3. Paste them into your VS Project Templates folder. (Typically Documents\Visual Studio 2015\Templates\ProjectTemplates)
  4. Open Visual Studio
  5. Create New Project
  6. Navigate to the Visual C# subtree
  7. Find the template(s) you added (ex: "Xamarin Forms Scalable Project")
  8. Select the template of your choosing
  9. Name the project
  10. Suggested: Right click Solution > Restore Nuget Packages
  11. Choose start up project from the three platforms
  12. Run

Resolving Issues

1. VS not responding after clicking on Create New Project

Because you've added a large template to your VS installation, it needs to initialize these in order for them to be usable. After a template is initialized, it is cached and this process will be quicker. Just give it some time.

2. Error Build action 'EmbeddedResource' is not supported by one or more of the project's targets

This error can happen when one of the Xamarin.Forms projects has issues updating from its nuget packages. Do a Clean, then Restore Nuget Packages, then try again.

Contributing

Pull Requests are checked bi-daily. Some of the main focuses for next steps are:

  1. Creating more templates for Xamarin Native projects
  2. Creating more templates for Xamarin projects that include wearables
  3. Creating more templates for Xamarin projects that include Xamarin.Mac projects as well as other .NET projects
  4. Creating more templates that include all possible mobile/desktop application projects
  5. Updating documentation
  6. Creating more rich example projects

More information

For details on the project structure, check out the README's in the src projects. They go into more details about the roles of each project and the source as a whole.

About

Templates for Xamarin / C# projects that use a scalable Onion Architecture

License:MIT License


Languages

Language:C# 100.0%