readme.html

<h1>ACR MvvmCross Plugins</h1>

<p>I loved Stuart Lodge's MvvmCross, so I built several services on it that I've used<br/>
on a few projects with great success.</p>

<ul>
<li>All plugins will be available through nuget</li>
<li>WinStore &amp; WinPhone platform plugins are in the works</li>
</ul>

<h2>Bar Code Scanner</h2>

<p>This is based on Redth's ZXing.Net.Mobile.</p>

<pre><code>new MvxCommand(async () =&gt; {
    var scan = Mvx.Resolve&lt;IBarCodeScanner&gt;();
    var r = await scan.Read(flashlightText: "Turn on flashlight", cancelText: "Cancel");

    Result = (r.Success 
        ? String.Format("Barcode Result - Format: {0} - Code: {1}", r.Format, r.Code)
        : "Cancelled barcode scan"
    );
});
</code></pre>

<h2>Cache</h2>

<p>TODO</p>

<h2>Device Info</h2>

<p>Allows you to get the information of the device for auditing purposes</p>

<h2>External App</h2>

<p>This allows you to open documents in other applications.  Useful if you have a document<br/>
repository style app</p>

<pre><code>if (ExternalAppService.Open("document.pdf")) {
    // app selection is already open
}   
else {
    throw new Exception("BOOM");
}
</code></pre>

<h2>Network</h2>

<p>I needed something beyond what MvvmCross had out of the box.  I had<br/>
a requirement for detecting network state changes so that we could inform<br/>
the user when they were working in an offline state.</p>

<pre><code>public MyViewModel(INetworkService networkService) {
    MvxSubscriptionToken networkSubscriptionToken = networkService.Subscribe(e =&gt; OnNetworkChange(e.Status));
    OnNetworkChange(networkService.CurrentStatus);
}

private void OnNetworkChange(MvxNetworkStatus e) {
    if (!e.IsConnected) {
        NetworkInfo = "Not Connected";
    }
    else if (e.IsMobile) {
        NetworkInfo = "Mobile Connection";
    }
    else {
        NetworkInfo = "WiFi Connection";
    }
}
</code></pre>

<h2>Settings</h2>

<p>Just a simple setting access platform service</p>

<h2>Storage</h2>

<p>Allows for PCL use of </p>

<ul>
<li>DirectoryInfo</li>
<li>FileInfo</li>
<li>and File Streams</li>
</ul>

<h2>User Dialogs</h2>

<p>Allows for messagebox style dialogs</p>

<ul>
<li>Alert</li>
<li>Prompt</li>
<li>Confirm</li>
<li>Loading</li>
<li>Progress</li>
<li><p>Toast</p>

<ol>
<li>Droid progress &amp; loading uses AndHUD</li>
<li>iOS progress &amp; loading uses BTProgressHUD</li>
</ol></li>
</ul>