在前兩篇老司機學Xamarin系列中，簡單介紹了Xamarin開發環境的搭建以及Prism和MvvmCross這兩個開發框架。不同的框架，往往不僅僅使用不同的架構風格，同時社群活躍度不同，各種功能模組和外掛數量也會有巨大差別。架構風格的好壞，屬於仁者見仁，但功能模組和外掛的好壞多寡，卻實實在在體現了社群的力量，是可以實打實拿出來練一練的。今天我們就來一起玩一玩MvvmCross提供的各種功能外掛，看看哪些輪子可以拿來直接就用的。

備註：本文主要關注相容Xamarin Forms xaml並且至少支援Droid和iOS平臺的外掛。

官方模組和外掛

在把視線放到社群貢獻的外掛之前，我們先來看看，MvvmCross框架官方提供了哪些模組、外掛：

Localization

Localization支援，對任何一個需要支援多國語言的App都必不可少。這個元件其實談不上MvvmCross特有，基本上是Xamarin官方文件推薦的最佳實踐。不過MvvmCross的VS專案模版直接包含了這個實現，並且整合到了MvvmCross自己的IoC容器的服務註冊。

在MvvmCross模版生成的專案中，資原始檔和獲取device當前語言的ILocalizeService介面定義在PCL Core專案中：

特定平臺的LocalizeService實現，定義在各自平臺專案的Services目錄中。在Setup類中預設將ILocalizeService註冊成為Singleton：

在任意xaml的View中，通過{res:Translate ResourceKey}這樣的格式繫結到控制元件的屬性：

DataBinding

資料繫結，是對任何App的View的顯示和互動必不可少的功能，這方面，Xamarin Forms本身的支援，就已經非常強悍了。MvvmCross有一個頁面專門介紹它對資料繫結的增強，然而，幾乎所有的增強貌似都是針對非Xamarin Forms xaml時期的Xamarin UI的資料繫結支援的，隨著Forms基於xaml的本身的資料繫結能力的出現和不斷增強，MvvmCross的這部分擴充套件其實已經過時了。

需要重點提及的是，在上面的LocalizeService元件的介紹中提到的{res:Translate ResourceKey}這樣的語法，其實是基於Xamarin Forms官方的

IMarkupExtension介面的擴充套件。而另一個可以用來擴充套件資料繫結的是IValueConverter介面。自定義的value converter，一般是用來在進行某個欄位的資料的儲存和資料的顯示之間的轉換的，但是，應該也可以利用它的語法來實現一些巧妙的資料繫結擴充套件。未來對Xamarin Forms UI元件的資料繫結的真正擴充套件，我想應該是基於上面提到的這兩個介面來實現。期望以後能看到各種有趣的外掛。當然，自己增加擴充套件也很容易。

簡單舉一個自定義IValueConverter的例子。假設我實現了下面這個自定義converter，用來自定義顯示某個model的長度屬性：

上面這個Converter的意思是，如果一個欄位在ViewModel裡面的屬性值為空，或者為0，顯示到頁面上時，顯示為Default，否則，顯示原來的值。假設ViewModel包含下面這個Length屬性，預設值為0：

xaml頁面的一個Label的Text，現在要繫結到上面這個Length屬性，並且，使用上面這個converter：

xaml裡稍微複雜一點，不過也不難理解。首先是定義一個名叫local的xmlns，然後需要將這個自定義的converter註冊到resource中，最後，在Label的Text屬性中指定繫結和converter。

Accelerometer

Accelerometer外掛讀取Accelerometer感測器的值。因為肯定要訪問裝置特定的API，它自然包含介面和對應不同裝置的具體實現。在專案中啟用一個MvvmCross的plugin，只需引用對應的nuget package。這個外掛對應的package是MvvmCross.Plugin.Accelerometer，可以從nuget.org下載。如果為一個包含shared PCL專案和Droid，iOS專案的solution新增這個外掛的nuget package後，會看到，shared專案只自動引用了包含IMvxAccelerometer介面的dll，而Droid專案和iOS專案則還自動引用了實現了IMvxAccelerometer介面的平臺特定的dll，並且，在Droid和iOS專案中的Boostrap目錄，會自動新增一個AccelerometerPluginBootstrap類，這個類是用於在App啟動時自動註冊外掛的，在這裡，特定來說，Bootstrap內部會自動註冊IMvxAccelerometer介面的實現。然後，我們就可以在程式碼裡訪問感測器的資料了。比如：

當訪問裝置特定的api時，還需要留意是否需要申請特定的裝置許可權。比如安卓裝置訪問Accelerometer就需要在Droid專案\Properties\AndroidManifest.xml檔案中新增一個users-feature如下：

可以看到，MvvmCross外掛的註冊機制非常巧妙，我一開始以為可能每個外掛至少需要有shared，droid，ios這樣多個nuget package，實際上，它只有一個nuget package，不同的專案型別自動引用了同一個package裡的不同target的dll，而且還自動添加了Bootstrap類，在框架層面通過反射和命名約定自動載入了外掛，使得整個外掛啟用過程不需手寫任何程式碼，非常贊！另外，除了通過Mvx.Resolve()獲取一個介面的例項之外，MvvmCross也支援建構函式注入，比如，可以為ViewModel的建構函式，新增一個IMvxAccelerometer引數，當ViewModel被IoC容器初始化時，建構函式的引數都會被自動注入。

Email

Email外掛，自然是用來發Email了。安裝nuget package：MvvmCross.Plugins.Email。它就包含了下面這個介面：

public interface IMvxComposeEmailTask
{
    void ComposeEmail(string to, string cc, string subject, string body, bool isHtml);
}

所以，發郵件至需要下面這樣的程式碼，不能再簡單了：

Mvx.Resolve<IMvxComposeEmailTask>()
   .ComposeEmail("[email protected]", 
                 string.Empty, 
                 "MvvmCross Email",
                 "I <3 MvvmCross",
                 false);

File

File外掛，提供了讀寫裝置本地檔案的能力。nuget package：MvvmCross.Plugins.File。Droid和iOS讀寫檔案時預設的當前目錄有差異（更多其他平臺的當前目錄，請參見官方文件）：

• Android - Context.FilesDir
• iOS - Environment.SpecialFolder.MyDocuments

實現的介面如下：

public interface IMvxFileStore
{
    bool TryReadTextFile(string path, out string contents);
    bool TryReadBinaryFile(string path, out Byte[] contents);
    bool TryReadBinaryFile(string path, Func<Stream, bool> readMethod);
    void WriteFile(string path, string contents);
    void WriteFile(string path, IEnumerable<Byte> contents);
    void WriteFile(string path, Action<Stream> writeMethod);
    bool TryMove(string from, string to, bool deleteExistingTo);
    bool Exists(string path);
    bool FolderExists(string folderPath);
    string PathCombine(string items0, string items1);
    string NativePath(string path);
    void EnsureFolderExists(string folderPath);
    IEnumerable<string> GetFilesIn(string folderPath);
    void DeleteFile(string path);
    void DeleteFolder(string folderPath, bool recursive);
}

具體使用方法類似其他外掛，只需要通過Mvx.Resolve()方法拿到instance，呼叫相應方法即可，這裡就不詳述了。

Location

Location外掛，用來獲取使用者當前的GPS位置資訊。nuget package: MvvmCross.Plugins.Location。實現了IMvxLocationWatcher介面：

public interface IMvxLocationWatcher
{
    void Start(
        MvxLocationOptions options, 
        Action<MvxGeoLocation> success, 
        Action<MvxLocationError> error);
    void Stop();
    bool Started { get; }

    MvxGeoLocation CurrentLocation { get; }
    MvxGeoLocation LastSeenLocation { get; }

    event EventHandler<MvxValueEventArgs<MvxLocationPermission>> OnPermissionChanged;
}

使用方式和Accelerometer類似，就不詳述了。

Messenger

Messenger外掛提供了基於記憶體的元件間基於訊息的pub/sub功能。非常有用的一個外掛。nuget package：MvvmCross.Plugins.Messenger。這是一個純PCL外掛，沒有平臺特定程式碼。實現了IMvxMessenger介面：

public interface IMvxMessenger
{
    MvxSubscriptionToken Subscribe<TMessage>(Action<TMessage> deliveryAction, MvxReference reference = MvxReference.Weak, string tag = null) where TMessage : MvxMessage;
    MvxSubscriptionToken SubscribeOnMainThread<TMessage>(Action<TMessage> deliveryAction, MvxReference reference = MvxReference.Weak, string tag = null) where TMessage : MvxMessage;

    MvxSubscriptionToken SubscribeOnThreadPoolThread<TMessage>(Action<TMessage> deliveryAction, MvxReference reference = MvxReference.Weak, string tag = null) where TMessage : MvxMessage;

    void Unsubscribe<TMessage>(MvxSubscriptionToken mvxSubscriptionId) where TMessage : MvxMessage;

    bool HasSubscriptionsFor<TMessage>() where TMessage : MvxMessage;

    int CountSubscriptionsFor<TMessage>() where TMessage : MvxMessage;

    bool HasSubscriptionsForTag<TMessage>(string tag) where TMessage : MvxMessage;

    int CountSubscriptionsForTag<TMessage>(string tag) where TMessage : MvxMessage;

    IList<string> GetSubscriptionTagsFor<TMessage>() where TMessage : MvxMessage;

    void Publish<TMessage>(TMessage message) where TMessage : MvxMessage;

    void Publish(MvxMessage message);

    void Publish(MvxMessage message, Type messageType);

    void RequestPurge(Type messageType);

    void RequestPurgeAll();
}

Network

Network外掛本來只是設計來檢測某個網路主機是否能連通。結果，功能被熱心網友不斷擴充，就成了一個輕量級的REST Http Client。nuget package：MvvmCross.Plugins.Network。它提供了下面這些介面的實現：

public interface IMvxReachability
{
    bool IsHostReachable(string host);
}

public interface IMvxRestClient
{
    void ClearSetting(string key);

    void SetSetting(string key, object value);

    IMvxAbortable MakeRequest(MvxRestRequest restRequest, Action<MvxRestResponse> successAction, Action<Exception> errorAction);
    IMvxAbortable MakeRequest(MvxRestRequest restRequest, Action<MvxStreamRestResponse> successAction, Action<Exception> errorAction);

    Task<MvxRestResponse> MakeRequestAsync(MvxRestRequest restRequest, CancellationToken cancellationToken = default(CancellationToken));
    Task<MvxStreamRestResponse> MakeStreamRequestAsync(MvxRestRequest restRequest, CancellationToken cancellationToken = default(CancellationToken));
}

public interface IMvxJsonRestClient
{
    Func<IMvxJsonConverter> JsonConverterProvider { get; set; }

    IMvxAbortable MakeRequestFor<T>(MvxRestRequest restRequest, Action<MvxDecodedRestResponse<T>> successAction, Action<Exception> errorAction);

    Task<MvxDecodedRestResponse<T>> MakeRequestForAsync<T>(MvxRestRequest restRequest, CancellationToken cancellationToken = default(CancellationToken));
}

PhoneCall

PhoneCall外掛自然是用來打電話的。nuget package：MvvmCross.Plugins.PhoneCall。實現了IMvxPhoneCallTask介面：

public interface IMvxPhoneCallTask
{
    void MakePhoneCall(string name, string number);
}

PictureChooser

PictureChooser用來從相簿選照片，或者用相機拍照。nuget package：MvvmCross.Plugins.PictureChooser。實現了IMvxPictureChooserTask介面：

public interface IMvxPictureChooserTask
{
    void ChoosePictureFromLibrary(int maxPixelDimension, int percentQuality, Action<Stream> pictureAvailable, Action assumeCancelled);

    void TakePicture(int maxPixelDimension, int percentQuality, Action<Stream> pictureAvailable, Action assumeCancelled);
}

簡單的使用程式碼如下：

var task = Mvx.Resolve<IMvxPictureChooserTask>();
task.ChoosePictureFromLibrary(500, 90,
       stream => {
           // use the stream
           // expect the stream to be disposed after immediately this method returns.
       },
       () => {
           // perform any cancelled operation
       });

Share

Share外掛用來發表分享。nuget package：MvvmCross.Plugins.Share。實現了IMvxShareTask介面：

public interface IMvxShareTask
{
    void ShareShort(string message);
    void ShareLink(string title, string message, string link);
}

SQLite

SQLite外掛是又一款必備外掛，用來訪問Sqlite資料庫。nuget package：MvvmCross.Plugin.SQLitePCL。實現了IMvxSqliteConnectionFactory介面：

public interface IMvxSqliteConnectionFactory
{
    SQLiteConnection GetConnection(string databaseName, bool prefixPlatformPath = true);
    SQLiteConnection GetConnection(SqLiteConfig config, bool prefixPlatformPath = true);
    SQLiteAsyncConnection GetAsyncConnection(string databaseName, bool prefixPlatformPath = true);
    SQLiteAsyncConnection GetAsyncConnection(SqLiteConfig config, bool prefixPlatformPath = true);
}

WebBrowser

WebBrowser外掛呼叫外部瀏覽器顯示一個頁面。nuget package：MvvmCross.Plugins.WebBrowser。實現了IMvxWebBrowserTask介面：

public interface IMvxWebBrowserTask
{
    void ShowWebPage(string url);
}

MvvmCross提供的官方外掛，推薦的就這些了。貌似還有點不過癮，好像很多期望的必備功能還沒看到？下面來看看社群的貢獻。

第三方外掛

Settings

Settings外掛提供了一個通用方案，用來持久化儲存key/value鍵值對到各平臺預設的App本地配置檔案。nuget package：Cheesebaron.MvxPlugins.Settings。實現了ISettings介面：

public interface ISettings
{
    /// <param name="roaming">Roam settings (only for WindowsCommon)</param>
    
    T GetValue<T>(string key, T defaultValue = default(T), bool roaming = false);
    bool AddOrUpdateValue<T>(string key, T value = default(T), bool roaming = false);
    bool DeleteValue(string key, bool roaming = false);
    bool Contains(string key, bool roaming = false);
    bool ClearAllValues(bool roaming = false);
}

DeviceInfo

DeviceInfo外掛支援獲取包括裝置解析度，裝置id，韌體版本，記憶體大小等等裝置資訊。nuget package：Cheesebaron.MvxPlugins.DeviceInfo。實現了IDeviceInfo和IDisplay介面：

public interface IDeviceInfo
{
    string DeviceId { get; }
    string Name { get; }
    string FirmwareVersion { get; }
    string HardwareVersion { get; }
    string Manufacturer { get; }
    string LanguageCode { get; }
    double TimeZoneOffset { get; }
    string TimeZone { get; }
    Orientation Orientation { get; }
    long TotalMemory { get; }
    bool IsTablet { get; }
    DeviceType DeviceType { get; }
}

public interface IDisplay
{
    int Height { get; }
    int Width { get; }
    double Xdpi { get; }
    double Ydpi { get; }
    double Scale { get; }
}

Connectivity

Connectivity外掛返回當前裝置是否聯網，當前使用WIFI還是行動網路。nuget package：Cheesebaron.MvxPlugins.Connectivity。實現了IConnectivity介面：

public interface IConnectivity: INotifyPropertyChanged
{
    bool IsConnected { get; }
    bool IsWifi { get; }
    bool IsCellular { get; }
    Task<bool> GetHostReachableAsync(string host, CancellationToken token = default(CancellationToken));
}

SMS

SMS插用來發送簡訊。nuget package：Cheesebaron.MvxPlugins.SMS。實現了ISmsTask介面：

public interface ISmsTask
{
    void SendSMS(string body, string phoneNumber);
}

SecureStorage

SecureStorage插用使用者儲存敏感資料key/value鍵值對到平臺特定的安全資料儲存，比如Keychain，Password Vault等。nuget package：Beezy.MvvmCross.Plugins.SecureStorage。實現了IMvxProtectedData介面：

public interface IMvxProtectedData
{
    void Protect(string key, string value);
    string Unprotect(string key);
    void Remove(string key);
}

InfiniteScrollPlugin

InfiniteScrollPlugin插用提供了一個能夠根據指定的資料來源，一直向下滾動分頁顯示資料的能力。nuget package：Sequence.Plugins.InfiniteScroll。實現了IIncrementalCollectionFactory介面。典型的示例可以參見這裡。

Fingerprint

Fingerprint提供指紋識別驗證支援。nuget package：MvvmCross.Plugins.Fingerprint。實現了IFingerprint介面：

    Task<FingerprintAvailability> GetAvailabilityAsync();
    Task<bool> IsAvailableAsync();
    Task<FingerprintAuthenticationResult> AuthenticateAsync(string reason, CancellationToken cancellationToken = default(CancellationToken));
    Task<FingerprintAuthenticationResult> AuthenticateAsync(AuthenticationRequestConfiguration authRequestConfig, CancellationToken cancellationToken = default(CancellationToken));

呼叫IFingerprint介面的示例：

var fpService = Mvx.Resolve<IFingerprint>(); // or use dependency injection and inject IFingerprint

var result = await fpService.AuthenticateAsync("Prove you have mvx fingers!");
if (result.Authenticated)
{
    // do secret stuff :)
}
else
{
    // not allowed to do secret stuff :(
}

UserInteraction

UserInteraction外掛實現了最常用的幾個UserDialogs，包括：Alert，Confirm和Input。nuget package：Chance.MvvmCross.Plugins.UserInteraction。它實現了IUserInteraction介面：

public interface IUserInteraction
{
    void Confirm(string message, Action okClicked, string title = null, string okButton = "OK", string cancelButton = "Cancel");
    void Confirm(string message, Action<bool> answer, string title = null, string okButton = "OK", string cancelButton = "Cancel");
    Task<bool> ConfirmAsync(string message, string title = "", string okButton = "OK", string cancelButton = "Cancel");

    void Alert(string message, Action done = null, string title = "", string okButton = "OK");
    Task AlertAsync(string message, string title = "", string okButton = "OK");

    void Input(string message, Action<string> okClicked, string placeholder = null, string title = null, string okButton = "OK", string cancelButton = "Cancel", string initialText = null);
    void Input(string message, Action<bool, string> answer, string placeholder = null, string title = null, string okButton = "OK", string cancelButton = "Cancel", string initialText = null);
    Task<InputResponse> InputAsync(string message, string placeholder = null, string title = null, string okButton = "OK", string cancelButton = "Cancel", string initialText = null);

    void ConfirmThreeButtons(string message, Action<ConfirmThreeButtonsResponse> answer, string title = null, string positive = "Yes", string negative = "No", string neutral = "Maybe");
    Task<ConfirmThreeButtonsResponse> ConfirmThreeButtonsAsync(string message, string title = null, string positive = "Yes", string negative = "No", string neutral = "Maybe");
}

User Dialogs

User Dialogs嚴格來說並不是一個標準的MvvmCross外掛。但是它提供了相比上面的UserInteraction更豐富的User Dialogs功能，所以，有需要的朋友也可以看一下。nuget package: Acr.UserDialogs。它可以和MvvmCrossy一起工作，但是沒有follow MvvmCross外掛自動初始化機制，因此，需要特別配置。引用package之後，需要在App類中註冊IUserDialog到Mvx的IoC容器：

Mvx.RegisterSingleton<IUserDialogs>(() => UserDialogs.Instance);

同時，對於Droid專案（iOS專案不需要），還必須在MvxFormsApplicationActivity類的OnCreate()方法裡，執行下面的初始化程式碼：

UserDialogs.Init(this);

然後，就可以在任意Command裡呼叫IUserDialogs介面的方法彈出Dialogs了。IUserDialogs介面支援下面這些Dialogs方法：

public interface IUserDialogs
{
    IDisposable Alert(string message, string title = null, string okText = null);
    IDisposable Alert(AlertConfig config);
    Task AlertAsync(string message, string title = null, string okText = null, CancellationToken? cancelToken = null);
    Task AlertAsync(AlertConfig config, CancellationToken? cancelToken = null);

    IDisposable ActionSheet(ActionSheetConfig config);
    Task<string> ActionSheetAsync(string title, string cancel, string destructive, CancellationToken? cancelToken = null, params string[] buttons);

    IDisposable Confirm(ConfirmConfig config);
    Task<bool> ConfirmAsync(string message, string title = null, string okText = null, string cancelText = null, CancellationToken? cancelToken = null);
    Task<bool> ConfirmAsync(ConfirmConfig config, CancellationToken? cancelToken = null);

    IDisposable DatePrompt(DatePromptConfig config);
    Task<DatePromptResult> DatePromptAsync(DatePromptConfig config, CancellationToken? cancelToken = null);
    Task<DatePromptResult> DatePromptAsync(string title = null, DateTime? selectedDate = null, CancellationToken? cancelToken = null);

    IDisposable TimePrompt(TimePromptConfig config);
    Task<TimePromptResult> TimePromptAsync(TimePromptConfig config, CancellationToken? cancelToken = null);
    Task<TimePromptResult> TimePromptAsync(string title = null, TimeSpan? selectedTime = null, CancellationToken? cancelToken = null);

    IDisposable Prompt(PromptConfig config);
    Task<PromptResult> PromptAsync(string message, string title = null, string okText = null, string cancelText = null, string placeholder = "", InputType inputType = InputType.Default, CancellationToken? cancelToken = null);
    Task<PromptResult> PromptAsync(PromptConfig config, CancellationToken? cancelToken = null);

    IDisposable Login(LoginConfig config);
    Task<LoginResult> LoginAsync(string title = null, string message = null, CancellationToken? cancelToken = null);
    Task<LoginResult> LoginAsync(LoginConfig config, CancellationToken? cancelToken = null);

    IProgressDialog Progress(ProgressDialogConfig config);
    IProgressDialog Loading(string title = null, Action onCancel = null, string cancelText = null, bool show = true, MaskType? maskType = null);
    IProgressDialog Progress(string title = null, Action onCancel = null, string cancelText = null, bool show = true, MaskType? maskType = null);

    void ShowLoading(string title = null, MaskType? maskType = null);
    void HideLoading();

    void ShowImage(IBitmap image, string message, int timeoutMillis = 2000);
    void ShowSuccess(string message, int timeoutMillis = 2000);
    void ShowError(string message, int timeoutMillis = 2000);

    IDisposable Toast(string title, TimeSpan? dismissTimer = null);
    IDisposable Toast(ToastConfig cfg);
}

AudioPlay

比較遺憾的是沒有看到支援音樂播放（比如播放線上或本地的mp3/wav）的外掛。這個應該是大多數App都需要的功能。搜尋了一些網上的實現方案，先給需要的朋友做個參考，要不下次咱把它改造成標準的MvvmCross外掛？

• https://github.com/srkrathore/AudioPlayEx
• http://www.cnblogs.com/fbsk/archive/2012/02/10/2345128.html
• http://blog.endpoint.com/2011/03/api-gaps-android-mediaplayer-example.html

2016-10-23 Update: 新增一些非MvvmCross，但是Xamarin下的通用第三方元件：

• Xamarin-Forms-Labs - 看上去是Xamarin界最大的一個第三方元件庫，包含了大量UI和Service等型別的好東西，元件列表太長了，不貼在這裡，大家可以點過去看。
• DLToolkit.Forms.Controls - DL Toolkit提供的幾個非常酷的元件，包括圖片轉換、增強的ListView和tag標籤功能等。
• DevExpress-Grid - 老牌大廠DevExpress出的Xamarin Forms資料表格控制元件，功能強大，竟然完全免費？！

暫時就這些了。如果您發現有別的優秀外掛，歡迎推薦，我也會持續補充進來。