Cross platform xamarin and windows plugins for PCLs
C# PowerShell
Permalink
Failed to load latest commit information.
.github Relocating files to new repos Jun 28, 2016
.nuget Fixes for settings nuget, forgot to add some xamarin.ios and renamed … Jul 27, 2015
AccessContextAndViewController Update README.md Nov 17, 2015
Battery Begin transition to independent repos Jun 28, 2016
Connectivity Relocating files to new repos Jun 28, 2016
Contacts Move contacts to new repo Sep 13, 2016
CurrentActivity Relocating files to new repos Jun 28, 2016
DeviceInfo Begin transition to independent repos Jun 28, 2016
ExternalMaps Begin transition to independent repos Jun 28, 2016
Geolocator Relocating files to new repos Jun 28, 2016
ImageCircle Begin transition to independent repos Jun 28, 2016
Media Relocating files to new repos Jun 28, 2016
MessageDialogs Update Circle Images Jul 6, 2015
Messages_Production Added Text To Speech Xamarin.Forms Dec 4, 2014
Messages_Sample Update message sample Nov 5, 2015
Permissions Relocating files to new repos Jun 28, 2016
Settings Relocating files to new repos Jun 28, 2016
TextToSpeech Begin transition to independent repos Jun 28, 2016
Vibrate Begin transition to independent repos Jun 28, 2016
.gitattributes Initial Commit Mar 12, 2014
.gitignore Finalize Plugins 2.0 Dec 1, 2015
LICENSE.md Update LICENSE.md Feb 28, 2016
README.md Update README.md Aug 8, 2016
bootstrapper.ps1 Change default script in bootstrapper Jan 20, 2016
build.cake Use pkgversion parameter instead (version is special for cake) Jan 20, 2016
install-android-sdk.ps1 rename file Jan 19, 2016
projects.yaml Connectivity ipv6 (#340) Jun 20, 2016

README.md

Plugins for Xamarin and Windows Projects

See a full list of community built plugins at: https://github.com/xamarin/plugins

Follow Me

What is this?

This is my main repo for all all Xamarin Plugins that I have or will be publishing. It is also example and documentation on how to create your very own PCL Plugin. These PCL plugins will allow you to add rich cross platform functionality to Xamarin, Xamarin.Forms and Windows Projects that use a PCLs or Shared Project.

Read more on my blog: http://motzcod.es/post/104507063997/what-exactly-is-a-plugin-for-xamarin

Contribute

My Plugins for Xamarin are completely open source and I encourage and accept pull requests! So please help out in any ways you can:

  1. Report Bugs: Open an Issue
  2. Submit Feature Requests: Open an Issue
  3. Fix a Bug or Add Feature: Send a Pull Request
  4. Create your Own Plugin : Learn How

My Current Plugins for Xamarin

Each plugin has a README with more information on what they contain. These are plugins I have created and maintain:

  • Battery Status: Get battery level, how it is getting charge, and events.
  • Connectivity: See if device is connected to the internet and through what connection type.
  • Contacts: Currently in Alpha to gather and query contacts
  • Device Information: Base information about each device such as OS and version.
  • Extended Maps: Launch navigation directions in default map app on each OS
  • Geolocator: Easy way of querying GPS location
  • Media: Take or pick photos/videos
  • Permissions: Check and request runtime permissions.
  • Settings: Fully cross platform settings for your application.
  • Share: Easily share text or open a browser
  • Text To Speech: Turn your text into a vocal symphony on mobile devices.
  • Vibrate: Make that device rumble!

Controls:

Awesome Plugins I Contribute To:

Other:

  • Messages_Sample: This is a simple test PCL NuGet to show anyone how easy it is to get a NuGet up and running. It uses an example of a stubbed out class and also a linked file class with #if's throughout it.

How PCL's Work!

PCL's consist of 2 concepts:

  • Reference Assembly (API Contract)
  • Implementation

Usually these 2 concepts exist together in one single assembly, however PCL's are special and allow you to separate your Reference Assembly from your implementation. This makes it extremely valuable to have platform specific implementations but develop against the same API on all platforms.

Compile vs Deploy

When we are creating a PCL library our PCL project will contain the API Contract with either an Interface that must be implemented on each platform or a stubbed our class that will be implemented on each platform. When we create our NuGet this reference assembly will be installed into our PCL that we can code against.

We will then create a separate project for each platform that we wish to support and implement the interface or stub class on each of them. The key here is that our reference assembly and each platform project have the SAME namespaces & assembly name. When we install into a specific platform via NuGet the platform specific DLL will be referenced.

The magic here is that while we are compiling against our reference assembly in the PCL when we go to deploy our application the reference assembly will be replaced with our platform specific implementation for the specific platform.

This is extremely powerful as long as you as a library creator ensure that your namespaces, assembly names, and all methods are implemented correctly on each platform.

Packaging up your your PCL

You will want to create a nuspec for your DLLs. I have examples in each of my projects for this. Once you have them done simply follow the guidelines: http://docs.nuget.org/docs/creating-packages/creating-and-publishing-a-package

You will want to ensure that you follow the naming guidelines for each platform:

Platform specific:

  • MonoTouch10
  • MonoAndroid10
  • Xamarin.iOS10
  • win8
  • wpa81
  • wp8
  • wp81
  • net45
  • MonoMac10
  • Xamarin.Mac20
  • UAP10

PCL:

  • portable-net45+win8+wp8+MonoTouch10+MonoAndroid10+wpa81+Xamarin.iOS10+UAP10

Important

  • Ensure namespaces are the same
  • Ensure that Assembly Names are the same. You will see all of mine are called Refractored.Xam.Messages.dll in all projects!

Thanks!

License

Licensed under MIT see License file. Each plugin licensed under parent license unless stated in it's readme file.