ios course

.gitignore

@@ -1,6 +1,7 @@
 bin
 Bin
 obj
+packages
 TestResults
 .DS_Store
 _ReSharper.*
@@ -13,4 +14,8 @@ _ReSharper.*
 *~
 *.swp
 *.pidb
-*.userprefs
+*.userprefs
+*.dotCover
+*.user
+*.ide
+*.DotSettings

.nuget/NuGet.Config

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="utf-8"?>
+<configuration>
+  <solution>
+    <add key="disableSourceControlIntegration" value="true" />
+  </solution>
+</configuration>

.nuget/NuGet.targets

@@ -0,0 +1,136 @@
+<?xml version="1.0" encoding="utf-8"?>
+<Project ToolsVersion="4.0" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
+    <PropertyGroup>
+        <SolutionDir Condition="$(SolutionDir) == '' Or $(SolutionDir) == '*Undefined*'">$(MSBuildProjectDirectory)\..\</SolutionDir>
+
+        <!-- Enable the restore command to run before builds -->
+        <RestorePackages Condition="  '$(RestorePackages)' == '' ">false</RestorePackages>
+
+        <!-- Property that enables building a package from a project -->
+        <BuildPackage Condition=" '$(BuildPackage)' == '' ">false</BuildPackage>
+
+        <!-- Determines if package restore consent is required to restore packages -->
+        <RequireRestoreConsent Condition=" '$(RequireRestoreConsent)' != 'false' ">true</RequireRestoreConsent>
+
+        <!-- Download NuGet.exe if it does not already exist -->
+        <DownloadNuGetExe Condition=" '$(DownloadNuGetExe)' == '' ">false</DownloadNuGetExe>
+    </PropertyGroup>
+
+    <ItemGroup Condition=" '$(PackageSources)' == '' ">
+        <!-- Package sources used to restore packages. By default, registered sources under %APPDATA%\NuGet\NuGet.Config will be used -->
+        <!-- The official NuGet package source (https://www.nuget.org/api/v2/) will be excluded if package sources are specified and it does not appear in the list -->
+        <!--
+            <PackageSource Include="https://www.nuget.org/api/v2/" />
+            <PackageSource Include="https://my-nuget-source/nuget/" />
+        -->
+    </ItemGroup>
+
+    <PropertyGroup Condition=" '$(OS)' == 'Windows_NT'">
+        <!-- Windows specific commands -->
+        <NuGetToolsPath>$([System.IO.Path]::Combine($(SolutionDir), ".nuget"))</NuGetToolsPath>
+        <PackagesConfig>$([System.IO.Path]::Combine($(ProjectDir), "packages.config"))</PackagesConfig>
+    </PropertyGroup>
+
+    <PropertyGroup Condition=" '$(OS)' != 'Windows_NT'">
+        <!-- We need to launch nuget.exe with the mono command if we're not on windows -->
+        <NuGetToolsPath>$(SolutionDir).nuget</NuGetToolsPath>
+        <PackagesConfig>packages.config</PackagesConfig>
+    </PropertyGroup>
+
+    <PropertyGroup>
+        <!-- NuGet command -->
+        <NuGetExePath Condition=" '$(NuGetExePath)' == '' ">$(NuGetToolsPath)\NuGet.exe</NuGetExePath>
+        <PackageSources Condition=" $(PackageSources) == '' ">@(PackageSource)</PackageSources>
+
+        <NuGetCommand Condition=" '$(OS)' == 'Windows_NT'">"$(NuGetExePath)"</NuGetCommand>
+        <NuGetCommand Condition=" '$(OS)' != 'Windows_NT' ">mono --runtime=v4.0.30319 $(NuGetExePath)</NuGetCommand>
+
+        <PackageOutputDir Condition="$(PackageOutputDir) == ''">$(TargetDir.Trim('\\'))</PackageOutputDir>
+
+        <RequireConsentSwitch Condition=" $(RequireRestoreConsent) == 'true' ">-RequireConsent</RequireConsentSwitch>
+        <NonInteractiveSwitch Condition=" '$(VisualStudioVersion)' != '' AND '$(OS)' == 'Windows_NT' ">-NonInteractive</NonInteractiveSwitch>
+
+        <PaddedSolutionDir Condition=" '$(OS)' == 'Windows_NT'">"$(SolutionDir) "</PaddedSolutionDir>
+        <PaddedSolutionDir Condition=" '$(OS)' != 'Windows_NT' ">"$(SolutionDir)"</PaddedSolutionDir>
+
+        <!-- Commands -->
+        <RestoreCommand>$(NuGetCommand) install "$(PackagesConfig)" -source "$(PackageSources)"  $(NonInteractiveSwitch) $(RequireConsentSwitch) -solutionDir $(PaddedSolutionDir)</RestoreCommand>
+        <BuildCommand>$(NuGetCommand) pack "$(ProjectPath)" -Properties "Configuration=$(Configuration);Platform=$(Platform)" $(NonInteractiveSwitch) -OutputDirectory "$(PackageOutputDir)" -symbols</BuildCommand>
+
+        <!-- We need to ensure packages are restored prior to assembly resolve -->
+        <BuildDependsOn Condition="$(RestorePackages) == 'true'">
+            RestorePackages;
+            $(BuildDependsOn);
+        </BuildDependsOn>
+
+        <!-- Make the build depend on restore packages -->
+        <BuildDependsOn Condition="$(BuildPackage) == 'true'">
+            $(BuildDependsOn);
+            BuildPackage;
+        </BuildDependsOn>
+    </PropertyGroup>
+
+    <Target Name="CheckPrerequisites">
+        <!-- Raise an error if we're unable to locate nuget.exe  -->
+        <Error Condition="'$(DownloadNuGetExe)' != 'true' AND !Exists('$(NuGetExePath)')" Text="Unable to locate '$(NuGetExePath)'" />
+        <!--
+        Take advantage of MsBuild's build dependency tracking to make sure that we only ever download nuget.exe once.
+        This effectively acts as a lock that makes sure that the download operation will only happen once and all
+        parallel builds will have to wait for it to complete.
+        -->
+        <MsBuild Targets="_DownloadNuGet" Projects="$(MSBuildThisFileFullPath)" Properties="Configuration=NOT_IMPORTANT;DownloadNuGetExe=$(DownloadNuGetExe)" />
+    </Target>
+
+    <Target Name="_DownloadNuGet">
+        <DownloadNuGet OutputFilename="$(NuGetExePath)" Condition=" '$(DownloadNuGetExe)' == 'true' AND !Exists('$(NuGetExePath)')" />
+    </Target>
+
+    <Target Name="RestorePackages" DependsOnTargets="CheckPrerequisites">
+        <Exec Command="$(RestoreCommand)"
+              Condition="'$(OS)' != 'Windows_NT' And Exists('$(PackagesConfig)')" />
+
+        <Exec Command="$(RestoreCommand)"
+              LogStandardErrorAsError="true"
+              Condition="'$(OS)' == 'Windows_NT' And Exists('$(PackagesConfig)')" />
+    </Target>
+
+    <Target Name="BuildPackage" DependsOnTargets="CheckPrerequisites">
+        <Exec Command="$(BuildCommand)" 
+              Condition=" '$(OS)' != 'Windows_NT' " />
+
+        <Exec Command="$(BuildCommand)"
+              LogStandardErrorAsError="true"
+              Condition=" '$(OS)' == 'Windows_NT' " />
+    </Target>
+
+    <UsingTask TaskName="DownloadNuGet" TaskFactory="CodeTaskFactory" AssemblyFile="$(MSBuildToolsPath)\Microsoft.Build.Tasks.v4.0.dll">
+        <ParameterGroup>
+            <OutputFilename ParameterType="System.String" Required="true" />
+        </ParameterGroup>
+        <Task>
+            <Reference Include="System.Core" />
+            <Using Namespace="System" />
+            <Using Namespace="System.IO" />
+            <Using Namespace="System.Net" />
+            <Using Namespace="Microsoft.Build.Framework" />
+            <Using Namespace="Microsoft.Build.Utilities" />
+            <Code Type="Fragment" Language="cs">
+                <![CDATA[
+                try {
+                    OutputFilename = Path.GetFullPath(OutputFilename);
+
+                    Log.LogMessage("Downloading latest version of NuGet.exe...");
+                    WebClient webClient = new WebClient();
+                    webClient.DownloadFile("https://www.nuget.org/nuget.exe", OutputFilename);
+
+                    return true;
+                }
+                catch (Exception ex) {
+                    Log.LogErrorFromException(ex);
+                    return false;
+                }
+            ]]>
+            </Code>
+        </Task>
+    </UsingTask>
+</Project>

Details.md

@@ -0,0 +1,107 @@
+Xamarin.Mobile is an API for accessing common platform features, such as
+reading the user's address book and using the camera, across iOS,
+Android, and Windows Phone.
+
+The goal of Xamarin.Mobile is to decrease the amount of
+platform-specific code needed to perform common tasks in multiplatform
+apps, making development simpler and faster.
+
+Xamarin.Mobile is currently a preview release and is subject to API
+changes.
+
+**Note:** The Windows Phone 7.1 version of the library requires the
+Microsoft.Bcl.Async NuGet package. You'll need to restore this package
+to use the samples or download this package to any WP7 app using
+Xamarin.Mobile.
+
+## Examples
+
+To access the address book (requires `READ_CONTACTS` permissions
+on Android):
+
+```csharp
+using Xamarin.Contacts;
+// ...
+
+var book = new Xamarin.Contacts.AddressBook ();
+//         new AddressBook (this); on Android
+if (!await book.RequestPermission()) {
+	Console.WriteLine ("Permission denied by user or manifest");
+	return;
+}
+
+foreach (Contact contact in book.OrderBy (c => c.LastName)) {
+	Console.WriteLine ("{0} {1}", contact.FirstName, contact.LastName);
+}
+```
+
+To get the user's location (requires `ACCESS_COARSE_LOCATION` and
+`ACCESS_FINE_LOCATION` permissions on Android):
+
+```csharp
+using Xamarin.Geolocation;
+// ...
+
+var locator = new Geolocator { DesiredAccuracy = 50 };
+//            new Geolocator (this) { ... }; on Android
+
+Position position = await locator.GetPositionAsync (timeout: 10000);
+
+Console.WriteLine ("Position Status: {0}", position.Timestamp);
+Console.WriteLine ("Position Latitude: {0}", position.Latitude);
+Console.WriteLine ("Position Longitude: {0}", position.Longitude);
+```
+
+To take a photo:
+
+```csharp
+using Xamarin.Media;
+// ...
+
+var picker = new MediaPicker ();
+if (!picker.IsCameraAvailable)
+	Console.WriteLine ("No camera!");
+else {
+	try {
+		MediaFile file = await picker.TakePhotoAsync (new StoreCameraMediaOptions {
+			Name = "test.jpg",
+			Directory = "MediaPickerSample"
+		});
+
+		Console.WriteLine (file.Path);
+	} catch (OperationCanceledException) {
+		Console.WriteLine ("Canceled");
+	}
+}
+```
+
+On Android (requires `WRITE_EXTERNAL_STORAGE` permissions):
+
+```csharp
+using Xamarin.Media;
+// ...
+
+protected override void OnCreate (Bundle bundle)
+{
+	var picker = new MediaPicker (this);
+	if (!picker.IsCameraAvailable)
+		Console.WriteLine ("No camera!");
+	else {
+		var intent = picker.GetTakePhotoUI (new StoreCameraMediaOptions {
+			Name = "test.jpg",
+			Directory = "MediaPickerSample"
+		});
+		StartActivityForResult (intent, 1);
+	}
+}
+
+protected override async void OnActivityResult (int requestCode, Result resultCode, Intent data)
+{
+	// User canceled
+	if (resultCode == Result.Canceled)
+		return;
+
+	MediaFile file = await data.GetMediaFileExtraAsync (this);
+	Console.WriteLine (file.Path);
+}
+```

GettingStarted.md

@@ -0,0 +1,123 @@
+## Examples
+
+### Contacts
+To access the address book (requires `READ_CONTACTS` permissions
+on Android):
+
+```csharp
+using Xamarin.Contacts;
+// ...
+
+var book = new Xamarin.Contacts.AddressBook ();
+book.RequestPermission().ContinueWith (t => {
+	if (!t.Result) {
+		Console.WriteLine ("Permission denied by user or manifest");
+		return;
+	}
+
+	foreach (Contact contact in book.OrderBy (c => c.LastName)) {
+		Console.WriteLine ("{0} {1}", contact.FirstName, contact.LastName);
+	}
+}, TaskScheduler.FromCurrentSynchronizationContext());
+```
+
+### Geolocation
+
+To get the user's location (requires `ACCESS_COARSE_LOCATION` and
+`ACCESS_FINE_LOCATION` permissions on Android):
+
+```csharp
+using Xamarin.Geolocation;
+// ...
+
+var locator = new Geolocator { DesiredAccuracy = 50 };
+//            new Geolocator (this) { ... }; on Android
+locator.GetPositionAsync (timeout: 10000).ContinueWith (t => {
+	Console.WriteLine ("Position Status: {0}", t.Result.Timestamp);
+	Console.WriteLine ("Position Latitude: {0}", t.Result.Latitude);
+	Console.WriteLine ("Position Longitude: {0}", t.Result.Longitude);
+}, TaskScheduler.FromCurrentSynchronizationContext());
+```
+
+NOTE: On iOS 8.0+ you must set either `NSLocationWhenInUseUsageDescription` or `NSLocationAlwaysUsageDescription` in your `Info.plist` file so that Xamarin.Mobile will request the appropriate permission from the user.
+
+### Media
+
+`MediaPicker` allows you to invoke the native UI to take or select photos or video. Given
+that there is this UI interaction, the code (while simpler than doing it manually) will not
+be completely cross-platform.
+
+To take a photo on iOS, Windows Phone or WinRT:
+
+```csharp
+using Xamarin.Media;
+// ...
+
+var picker = new MediaPicker();
+picker.PickPhotoAsync().ContinueWith (t => {
+	MediaFile file = t.Result;
+	Console.WriteLine (file.Path);
+}, TaskScheduler.FromCurrentSynchronizationContext());
+```
+
+On Android and optionally on iOS, you control the UI.
+
+To take a photo on Android (requires `WRITE_EXTERNAL_STORAGE` permissions):
+
+```csharp
+using Xamarin.Media;
+// ...
+
+protected override void OnCreate (Bundle bundle)
+{
+	var picker = new MediaPicker (this);
+	if (!picker.IsCameraAvailable)
+		Console.WriteLine ("No camera!");
+	else {
+		var intent = picker.GetTakePhotoUI (new StoreCameraMediaOptions {
+			Name = "test.jpg",
+			Directory = "MediaPickerSample"
+		});
+		StartActivityForResult (intent, 1);
+	}
+}
+
+protected override void OnActivityResult (int requestCode, Result resultCode, Intent data)
+{
+	// User canceled
+	if (resultCode == Result.Canceled)
+		return;
+
+	data.GetMediaFileExtraAsync (this).ContinueWith (t => {
+		Console.WriteLine (t.Result.Path);
+	}, TaskScheduler.FromCurrentSynchronizationContext());
+}
+```
+
+To take a photo on iOS controlling the UI:
+
+```csharp
+using Xamarin.Media;
+// ...
+
+var picker = new MediaPicker();
+MediaPickerController controller = picker.GetTakePhotoUI (new StoreCameraMediaOptions {
+	Name = "test.jpg",
+	Directory = "MediaPickerSample"
+});
+
+// On iPad, you'll use UIPopoverController to present the controller
+PresentViewController (controller, true, null);
+
+controller.GetResultAsync().ContinueWith (t => {
+	// Dismiss the UI yourself
+	controller.DismissViewController (true, () => {
+		MediaFile file = t.Result;
+	});
+
+}, TaskScheduler.FromCurrentSynchronizationContext());
+```
+#####Note to iOS 8 Developers
+Showing a `MediaPicker` in response to a `UIActionSheet.Clicked` event will cause unexpected behavior on iOS 8.  Apps should be updated to conditionally use an `UIAlertController` with a style of `UIAlertControllerStyle.ActionSheet.`  See the iOS sample for more info. 
+
+