readme.md

ACR User Dialogs for Xamarin and Windows

A cross platform library that allows you to call for standard user dialogs from a shared/portable library. Supports Android, iOS, and Unified Windows Platform (UWP, UAP)

Change Log - Nov1/2016

Features

Docs are a work in progress of Nov 1, 2016

• Action Sheet

• Alert

• Confirm

• Date

• Loading/Progress

• Login

• Prompt

• Toasts

• Time

• Source Code

• FAQ

Support Platforms

• iOS 8+
• Android
• Universal Windows Platform (Win10/UWP)
• Portable Class Libraries (Profile 259)

Experimental Platforms (no support)

• tvOS
• WPF/NET45
• Windows Phone 8/8.1
• MacOS - coming soon

Setup

To use, simply reference the nuget package in each of your platform projects.

iOS and Windows

Nothing is necessary any longer as of v4.x.  There is an Init function for iOS but it is OPTIONAL and only required if you want/need to control
the top level viewcontroller for things like iOS extensions.  Progress prompts will not use this factory function though!

Android Initialization (In your main activity)

UserDialogs.Init(this);
OR UserDialogs.Init(() => provide your own top level activity provider)
OR MvvmCross - UserDialogs.Init(() => Mvx.Resolve<IMvxAndroidCurrentTopActivity>().Activity)
OR Xamarin.Forms - UserDialogs.Init(() => (Activity)Forms.Context)

MvvmCross

// from your PCL app.cs (remember to Init on android platform project)
Mvx.RegisterSingleton<IUserDialogs>(() => UserDialogs.Instance);

Powered By:

• Android - Progress/Loading uses Redth's AndHUD
• iOS - Progress/Loading uses Nic Wise's BTProgressHUD
• iOS - Toasts powered by TTGSnackBar ported by @MarcBruins (https://github.com/MarcBruins/TTGSnackbar-Xamarin-iOS)
• iOS - Date/Time Picker powered by AIDatePicker ported by @MarcBruins (https://github.com/MarcBruins/AIDatePickerController-Xamarin-iOS)
• UWP - Coding4Fun Toolkit (http://coding4fun.codeplex.com)
• Splat - Provides a nice layer of xplat stuff by @paulcbetts (https://github.com/paulcbetts)