diff --git a/AccelerometerPlay/README.md b/AccelerometerPlay/README.md index 960b1d347..35f29993b 100644 --- a/AccelerometerPlay/README.md +++ b/AccelerometerPlay/README.md @@ -1,5 +1,16 @@ -Accelerometer Play -================== +--- +name: Xamarin.Android - Accelerometer Play +description: This sample demonstrates usage of the accelerometer to animate balls rolling on a wooden table. +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: accelerometerplay +--- +# Accelerometer Play This sample demonstrates usage of the accelerometer to animate balls rolling on a wooden table. diff --git a/AccessoryViews/README.md b/AccessoryViews/README.md index d1cf49b46..f4002c7ac 100644 --- a/AccessoryViews/README.md +++ b/AccessoryViews/README.md @@ -1,4 +1,15 @@ -AccessoryViews -============== +--- +name: Xamarin.Android - AccessoryViews +description: This sample is part of the Android ListViews and Adapters series. +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: accessoryviews +--- +# AccessoryViews This sample is part of the Android ListViews and Adapters series. \ No newline at end of file diff --git a/ActionBarViewPager/Readme.md b/ActionBarViewPager/Readme.md index 11bbc05ed..7e3b98790 100644 --- a/ActionBarViewPager/Readme.md +++ b/ActionBarViewPager/Readme.md @@ -1,5 +1,16 @@ -HelloSwipeViewWithTabs -====================== +--- +name: Xamarin.Android - HelloSwipeViewWithTabs +description: 'Author: Richard Lander -- rlander@microsoft.com License: Apache 2 This sample app demonstrates how to use ViewPager and ActionBar together....' +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: actionbarviewpager +--- +# HelloSwipeViewWithTabs Author: Richard Lander -- rlander@microsoft.com diff --git a/ActivityLifecycle/README.md b/ActivityLifecycle/README.md index 74cd845a9..ffc830597 100644 --- a/ActivityLifecycle/README.md +++ b/ActivityLifecycle/README.md @@ -1,5 +1,16 @@ -Android Activity Lifecycle -========================== +--- +name: Xamarin.Android - Android Activity Lifecycle +description: This sample app accompanies the article, Walkthrough - Saving the Activity State. ![](Screenshots/example-screenshot.png) +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: activitylifecycle +--- +# Android Activity Lifecycle This sample app accompanies the article, [Walkthrough - Saving the Activity State](http://developer.xamarin.com/guides/android/application_fundamentals/activity_lifecycle/saving_state_walkthrough). diff --git a/AdvancedAppLifecycleDemos/README.md b/AdvancedAppLifecycleDemos/README.md index 67b2706b2..3520b8aea 100644 --- a/AdvancedAppLifecycleDemos/README.md +++ b/AdvancedAppLifecycleDemos/README.md @@ -1,5 +1,16 @@ -ActivityLifecycle Demos -======================= +--- +name: Xamarin.Android - ActivityLifecycle Demos +description: 'Four sample projects that cover advanced activity and application lifecycle scenarios in Android: ActivityLifecycle - Handling the activity...' +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: advancedapplifecycledemos +--- +# ActivityLifecycle Demos Four sample projects that cover advanced activity and application lifecycle scenarios in Android: * ActivityLifecycle - Handling the activity lifecycle including rotation and subscribing to external events @@ -7,6 +18,5 @@ Android: * HandlingCrashes - Gracefully handling app crashes, waiting for app initializing and launching specific activities after crashes * InitializingAppAndServices - Handling multiple asynchronous initializations -Authors -------- +## Authors Bryan Costanich \ No newline at end of file diff --git a/AdvancedImmersiveMode/README.md b/AdvancedImmersiveMode/README.md index 9bfdf6773..7ad6a95b8 100644 --- a/AdvancedImmersiveMode/README.md +++ b/AdvancedImmersiveMode/README.md @@ -1,5 +1,16 @@ -Advanced Immersive Mode -================== +--- +name: Xamarin.Android - Advanced Immersive Mode +description: Android 4.4 introduces a way for you to provide a more immersive screen experience in your app, by letting users show or hide the status bar and... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: advancedimmersivemode +--- +# Advanced Immersive Mode Android 4.4 introduces a way for you to provide a more immersive screen experience in your app, by letting users show or hide the status bar and navigation bar with a swipe. diff --git a/AndroidBeamDemo/README.md b/AndroidBeamDemo/README.md index 1d805bc32..639501f8e 100644 --- a/AndroidBeamDemo/README.md +++ b/AndroidBeamDemo/README.md @@ -1,5 +1,16 @@ -Android Beam Demo -================= +--- +name: Xamarin.Android - Android Beam Demo +description: This is a port of Android SDK samples. It demonstrates new Android Beam (new NFC feature) in Ice Cream Sandwich. +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: androidbeamdemo +--- +# Android Beam Demo This is a port of Android SDK samples. diff --git a/AnimationDemo/README.md b/AnimationDemo/README.md index 410eb4e34..05d0b35e9 100644 --- a/AnimationDemo/README.md +++ b/AnimationDemo/README.md @@ -1,5 +1,16 @@ -Android Animation Demo -====================== +--- +name: Xamarin.Android - Android Animation Demo +description: This sample app accompanies the article, Graphics and Animations. ![](Screenshots/example-screens.png) +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: animationdemo +--- +# Android Animation Demo This sample app accompanies the article, [Graphics and Animations](http://developer.xamarin.com/guides/android/application_fundamentals/graphics_and_animation). diff --git a/ApiDemo/README.md b/ApiDemo/README.md index 245ac09d9..f32b99e1e 100644 --- a/ApiDemo/README.md +++ b/ApiDemo/README.md @@ -1,5 +1,16 @@ -Android API Demo -================ +--- +name: Xamarin.Android - Android API Demo +description: 'This sample includes a variety of small applications that illustrate the use of various Android APIs. It includes samples of: - Notifications -...' +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: apidemo +--- +# Android API Demo This sample includes a variety of small applications that illustrate the use of various Android APIs. It includes samples of: @@ -16,7 +27,6 @@ the use of various Android APIs. It includes samples of: - Voice Recognition - And many many more... -Build Requirements --------- +## Build Requirements Building this sample requires that the API 19 (KitKat) SDK be installed, as well as Android SDK Build-tools 19.0.1 or greater. diff --git a/ApplicationFundamentals/FingerPaint/README.md b/ApplicationFundamentals/FingerPaint/README.md index f0aa89bb6..fd91fbfce 100644 --- a/ApplicationFundamentals/FingerPaint/README.md +++ b/ApplicationFundamentals/FingerPaint/README.md @@ -1,8 +1,20 @@ -Multi-Touch Tracking in Android -======================= +--- +name: Xamarin.Android - Multi-Touch Tracking in Android +description: FingerPaint sample for Multi-Touch Tracking +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: applicationfundamentals-fingerpaint +--- +# Multi-Touch Tracking in Android FingerPaint sample for [Multi-Touch Tracking](/guides/android/application_fundamentals/touch/touch_tracking/) -Author ------- +![Multi-Touch Tracking in Android application screenshot](Screenshots/image01.png "Multi-Touch Tracking in Android application screenshot") + +## Author Charles Petzold diff --git a/ApplicationFundamentals/RotationDemo/README.md b/ApplicationFundamentals/RotationDemo/README.md index c45cf546e..e614c7833 100644 --- a/ApplicationFundamentals/RotationDemo/README.md +++ b/ApplicationFundamentals/RotationDemo/README.md @@ -1,5 +1,16 @@ -Rotation Demo -============= +--- +name: Xamarin.Android - Rotation Demo +description: This sample app accompanies the article, Handling Rotation. +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: applicationfundamentals-rotationdemo +--- +# Rotation Demo This sample app accompanies the article, [Handling Rotation](http://developer.xamarin.com/guides/android/application_fundamentals/handling_rotation). diff --git a/ApplicationFundamentals/ServiceSamples/BoundServiceDemo/README.md b/ApplicationFundamentals/ServiceSamples/BoundServiceDemo/README.md index 55a9813dc..944adc587 100644 --- a/ApplicationFundamentals/ServiceSamples/BoundServiceDemo/README.md +++ b/ApplicationFundamentals/ServiceSamples/BoundServiceDemo/README.md @@ -1,11 +1,23 @@ -Xamarin.Android Bound Service Sample -==================================== +--- +name: Xamarin.Android - Xamarin.Android Bound Service Sample +description: This directory holds the sample project from the creating a bound service section of the Creating Services guide for Xamarin.Android.... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: applicationfundamentals-servicesamples-boundservicedemo +--- +# Xamarin.Android Bound Service Sample This directory holds the sample project from the [creating a bound service section](https://developer.xamarin.com/guides/android/application_fundamentals/services/creating-a-service/bound-services/) of the [Creating Services](https://developer.xamarin.com/guides/android/application_fundamentals/services/) guide for Xamarin.Android. ![](./Screenshots/bound-service.png) -Authors -------- +![Xamarin.Android Bound Service Sample application screenshot](Screenshots/bound-service.png "Xamarin.Android Bound Service Sample application screenshot") + +## Authors Tom Opgenorth (toopge@microsoft.com) \ No newline at end of file diff --git a/ApplicationFundamentals/ServiceSamples/ForegroundServiceDemo/README.md b/ApplicationFundamentals/ServiceSamples/ForegroundServiceDemo/README.md index 81e34a460..73d873716 100644 --- a/ApplicationFundamentals/ServiceSamples/ForegroundServiceDemo/README.md +++ b/ApplicationFundamentals/ServiceSamples/ForegroundServiceDemo/README.md @@ -1,11 +1,23 @@ -Xamarin.Android Foreground Service Sample -========================================= +--- +name: Xamarin.Android - Xamarin.Android Foreground Service Sample +description: This directory holds the sample project from the creating a foreground service section of the Creating Services guide for Xamarin.Android.... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: applicationfundamentals-servicesamples-foregroundservicedemo +--- +# Xamarin.Android Foreground Service Sample This directory holds the sample project from the [creating a foreground service](https://developer.xamarin.com/guides/android/application_fundamentals/services/creating-a-service/bound-services/) section of the [Creating Services](https://developer.xamarin.com/guides/android/application_fundamentals/services/) guide for Xamarin.Android. ![](./Screenshots/foreground-service.png) -Authors -------- +![Xamarin.Android Foreground Service Sample application screenshot](Screenshots/foreground-service.png "Xamarin.Android Foreground Service Sample application screenshot") + +## Authors Tom Opgenorth (toopge@microsoft.com) diff --git a/ApplicationFundamentals/ServiceSamples/MessengerServiceDemo/README.md b/ApplicationFundamentals/ServiceSamples/MessengerServiceDemo/README.md index babb4d318..8b9502071 100644 --- a/ApplicationFundamentals/ServiceSamples/MessengerServiceDemo/README.md +++ b/ApplicationFundamentals/ServiceSamples/MessengerServiceDemo/README.md @@ -1,5 +1,16 @@ -Xamarin.Android Messenger and Service Sample -============================================ +--- +name: Xamarin.Android - Xamarin.Android Messenger and Service Sample +description: This solution is an example of IPC communication between an Android service and an Activity (using a Messenger and a Handler). It demonstates how... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: applicationfundamentals-servicesamples-messengerservicedemo +--- +# Xamarin.Android Messenger and Service Sample This solution is an example of IPC communication between an Android service and an Activity (using a Messenger and a Handler). It demonstates how to perform one-way and two-way IPC calls between an Activity and a Service running in it's own process. @@ -10,7 +21,8 @@ Ensure that the **MessengerService** project is installed on the device _before_ **Note**: Currently it is not possible to implement an `IsolatedProcess` in Xamarin.Android. Please see [Bugzilla 51940 - Services with isolated processes and custom Application class fail to resolve overloads properly](https://bugzilla.xamarin.com/show_bug.cgi?id=51940) for more details. -Authors -------- +![Xamarin.Android Messenger and Service Sample application screenshot](Screenshots/service-messenger-activity.png "Xamarin.Android Messenger and Service Sample application screenshot") + +## Authors Tom Opgenorth (toopge@microsoft.com) diff --git a/ApplicationFundamentals/ServiceSamples/StartedServicesDemo/README.md b/ApplicationFundamentals/ServiceSamples/StartedServicesDemo/README.md index e7c719e09..4d7d3248d 100644 --- a/ApplicationFundamentals/ServiceSamples/StartedServicesDemo/README.md +++ b/ApplicationFundamentals/ServiceSamples/StartedServicesDemo/README.md @@ -1,11 +1,23 @@ -Xamarin.Android Started Service Sample -====================================== +--- +name: Xamarin.Android - Xamarin.Android Started Service Sample +description: This directory holds the sample project for the creating a started service section of the Creating Services guide for Xamarin.Android.... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: applicationfundamentals-servicesamples-startedservicesdemo +--- +# Xamarin.Android Started Service Sample This directory holds the sample project for the [creating a started service section](https://developer.xamarin.com/guides/android/application_fundamentals/services/creating-a-service/started-services/) of the [Creating Services](https://developer.xamarin.com/guides/android/application_fundamentals/services/) guide for Xamarin.Android. ![](./Screenshots/started-service.png) -Authors -------- +![Xamarin.Android Started Service Sample application screenshot](Screenshots/started-service.png "Xamarin.Android Started Service Sample application screenshot") + +## Authors Tom Opgenorth (toopge@microsoft.com) diff --git a/ApplicationFundamentals/Touch_final/README.md b/ApplicationFundamentals/Touch_final/README.md index e99f977d4..546f050e2 100644 --- a/ApplicationFundamentals/Touch_final/README.md +++ b/ApplicationFundamentals/Touch_final/README.md @@ -1,4 +1,15 @@ -Touch in Android (Completed Sample) -======================= +--- +name: Xamarin.Android - Touch in Android (Completed Sample) +description: Complete sample for Using Touch in Android +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: applicationfundamentals-touch-final +--- +# Touch in Android (Completed Sample) Complete sample for [Using Touch in Android](http://developer.xamarin.com/guides/cross-platform/application_fundamentals/touch/part_4_android_touch_walkthrough/) diff --git a/ApplicationFundamentals/Touch_start/README.md b/ApplicationFundamentals/Touch_start/README.md index af8bce8ee..f00001fcf 100644 --- a/ApplicationFundamentals/Touch_start/README.md +++ b/ApplicationFundamentals/Touch_start/README.md @@ -1,4 +1,15 @@ -Touch in Android (Walkthrough) -===== +--- +name: Xamarin.Android - Touch in Android (Walkthrough) +description: Walkthrough starting point for Using Touch in Android Walkthrough +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: applicationfundamentals-touch-start +--- +# Touch in Android (Walkthrough) Walkthrough starting point for [Using Touch in Android Walkthrough](http://developer.xamarin.com/guides/cross-platform/application_fundamentals/touch/part_4_android_touch_walkthrough/) diff --git a/AsyncImageAndroid/README.md b/AsyncImageAndroid/README.md index 628ab024a..07bced067 100644 --- a/AsyncImageAndroid/README.md +++ b/AsyncImageAndroid/README.md @@ -1,5 +1,16 @@ -AsyncImageAndroid -=========== +--- +name: Xamarin.Android - AsyncImageAndroid +description: This sample application demonstrates how to use the new Async/Await feature which is available in Xamarin.Android 4.8. The sample download a large... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: asyncimageandroid +--- +# AsyncImageAndroid This sample application demonstrates how to use the new Async/Await feature which is available in Xamarin.Android 4.8. diff --git a/BasicImmersiveMode/README.md b/BasicImmersiveMode/README.md index e1a07179a..b7ed99ba3 100644 --- a/BasicImmersiveMode/README.md +++ b/BasicImmersiveMode/README.md @@ -1,5 +1,16 @@ -Basic Immersive Mode -================== +--- +name: Xamarin.Android - Basic Immersive Mode +description: Android 4.4 introduces a way for you to provide a more immersive screen experience in your app, by letting users show or hide the status bar and... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: basicimmersivemode +--- +# Basic Immersive Mode Android 4.4 introduces a way for you to provide a more immersive screen experience in your app, by letting users show or hide the status bar and navigation bar with a swipe. diff --git a/BasicTableAdapter/README.md b/BasicTableAdapter/README.md index b20f0a7bd..2ab6b5238 100644 --- a/BasicTableAdapter/README.md +++ b/BasicTableAdapter/README.md @@ -1,4 +1,15 @@ -Basic Table Adapter -=================== +--- +name: Xamarin.Android - Basic Table Adapter +description: This sample is part of the Android ListViews and Adapters series. +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: basictableadapter +--- +# Basic Table Adapter This sample is part of the Android ListViews and Adapters series. \ No newline at end of file diff --git a/BasicTableAndroid/README.md b/BasicTableAndroid/README.md index 6481a0429..dd83ef69e 100644 --- a/BasicTableAndroid/README.md +++ b/BasicTableAndroid/README.md @@ -1,4 +1,15 @@ -Basic Table Android -=================== +--- +name: Xamarin.Android - Basic Table Android +description: This sample is part of the Android ListViews and Adapters series. +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: basictableandroid +--- +# Basic Table Android This sample is part of the Android ListViews and Adapters series. \ No newline at end of file diff --git a/BatchStepSensor/README.md b/BatchStepSensor/README.md index 4db06a348..7e7ddeb1e 100644 --- a/BatchStepSensor/README.md +++ b/BatchStepSensor/README.md @@ -1,9 +1,19 @@ -BatchStepSensor -============= +--- +name: Xamarin.Android - BatchStepSensor +description: This sample demonstrates how to set up and use Android 4.4's step counting APIs with batching (letting the system collect multiple step events... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: batchstepsensor +--- +# BatchStepSensor This sample demonstrates how to set up and use Android 4.4's step counting APIs with batching (letting the system collect multiple step events before returning them to the application.) -How to Build and Run this Sample -========================== +# How to Build and Run this Sample To build, install Xamarin Studio or Xamarin for Visual Studio, open the project in your selected IDE and build. In order to fully use this sample, you should deploy to a device that had step counting sensors. This sample requires Android 4.4 (KitKat). \ No newline at end of file diff --git a/BluetoothChat/README.md b/BluetoothChat/README.md index 5315d73d6..c37efa756 100644 --- a/BluetoothChat/README.md +++ b/BluetoothChat/README.md @@ -1,5 +1,16 @@ -Bluetooth Chat -============== +--- +name: Xamarin.Android - Bluetooth Chat +description: This is a port of the Android BluetoothChat sample. It demonstrates using the Bluetooth APIs to create a sample chat client. This sample has a... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: bluetoothchat +--- +# Bluetooth Chat This is a port of the [Android BluetoothChat sample](https://github.com/googlesamples/android-BluetoothChat). diff --git a/BorderlessButtons/README.md b/BorderlessButtons/README.md index 7dd5e51a2..ef443cdbb 100644 --- a/BorderlessButtons/README.md +++ b/BorderlessButtons/README.md @@ -1,5 +1,16 @@ -Borderless Buttons -================== +--- +name: Xamarin.Android - Borderless Buttons +description: This sample demonstrates the borderless button styling from the Holo visual language. The most interesting bits in this sample are in the layout... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: borderlessbuttons +--- +# Borderless Buttons This sample demonstrates the **borderless button** styling from the Holo visual language. The most interesting bits in this sample are in the layout files (res/layout/). diff --git a/BouncingGameCompleteAndroid/README.md b/BouncingGameCompleteAndroid/README.md index 0fd2d2575..09c627aa8 100644 --- a/BouncingGameCompleteAndroid/README.md +++ b/BouncingGameCompleteAndroid/README.md @@ -1,5 +1,16 @@ -CocosSharp BouncingGame Project for Android -==================================== +--- +name: Xamarin.Android - CocosSharp BouncingGame Project for Android +description: This is a small, complete game using CocosSharp for Android. It is the result of working through the the entire Introduction to CocosSharp... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: bouncinggamecompleteandroid +--- +# CocosSharp BouncingGame Project for Android This is a small, complete game using CocosSharp for Android. It is the result of working through the the entire Introduction to CocosSharp walkthrough. @@ -7,7 +18,8 @@ This single solution contains two projects: one for Android and one cross-platf The game can be played by touching the screen to move the paddle at the bottom of the screen horizontally. The goal is to keep the ball from falling off-screen. Each bounce awards the player one point. -Author ------- +![CocosSharp BouncingGame Project for Android application screenshot](Screenshots/FinalBouncingGameScreen.png "CocosSharp BouncingGame Project for Android application screenshot") + +## Author Victor Chelaru \ No newline at end of file diff --git a/BouncingGameEmptyAndroid/README.md b/BouncingGameEmptyAndroid/README.md index c5ce3a98e..3b15e6241 100644 --- a/BouncingGameEmptyAndroid/README.md +++ b/BouncingGameEmptyAndroid/README.md @@ -1,5 +1,16 @@ -CocosSharp Empty Project for Android -==================================== +--- +name: Xamarin.Android - CocosSharp Empty Project for Android +description: This project serves as a starting-point for CocosSharp Android projects. It is the result of working through the Part 2 - Creating Android... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: bouncinggameemptyandroid +--- +# CocosSharp Empty Project for Android This project serves as a starting-point for CocosSharp Android projects. It is the result of working through the Part 2 - Creating Android CocosSharp Project walkthrough. It is titled BouncingGame as that is the name of the project created by the full Introduction to CocosSharp walkthrough. @@ -7,7 +18,8 @@ This single solution contains two projects: one for Android and one cross-platf When executed this project displays only a black screen. -Author ------- +![CocosSharp Empty Project for Android application screenshot](Screenshots/Screenshot1.png "CocosSharp Empty Project for Android application screenshot") + +## Author Victor Chelaru \ No newline at end of file diff --git a/BuiltInViews/README.md b/BuiltInViews/README.md index e9387be11..37411f08c 100644 --- a/BuiltInViews/README.md +++ b/BuiltInViews/README.md @@ -1,12 +1,22 @@ -Built In Views -============== +--- +name: Xamarin.Android - Built In Views +description: 'This sample is part of the Android ListViews and Adapters series; it includes two projects that illustrate built-in ListViews. Note: to use...' +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: builtinviews +--- +# Built In Views This sample is part of the Android ListViews and Adapters series; it includes two projects that illustrate built-in ListViews. Note: to use SimpleSelectableListItem, SimpleListItemActivated1, or SimpleListItemActivated2, you need API level 11 or higher. For more about built-in ListViews (and to view screenshots from this sample), see the accompanying article [ListViews and Adapters, Part 3 - Customizing a ListView's Appearance](http://developer.xamarin.com/guides/android/user_interface/working_with_listviews_and_adapters/part_3_-_customizing_a_listview's_appearance). -Authors -------- +## Authors Mark McLemore (BuiltInExpandableViews) diff --git a/Button/README.md b/Button/README.md index 79d620e79..e26315106 100644 --- a/Button/README.md +++ b/Button/README.md @@ -1,4 +1,15 @@ -Button Widget -============= +--- +name: Xamarin.Android - Button Widget +description: Shows how to use a simple button widget. +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: button +--- +# Button Widget Shows how to use a simple button widget. diff --git a/CalendarDemo/README.md b/CalendarDemo/README.md index 6820bbe4c..655db87fd 100644 --- a/CalendarDemo/README.md +++ b/CalendarDemo/README.md @@ -1,5 +1,16 @@ -Calendar Demo -============= +--- +name: Xamarin.Android - Calendar Demo +description: This example shows how to use the calendar API to list calendars and events. It also shows how to add an event and view it using the built-in... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: calendardemo +--- +# Calendar Demo This example shows how to use the calendar API to list calendars and events. It also shows how to add an event and view it using the built-in calendar app. diff --git a/CardEmulation/Readme.md b/CardEmulation/Readme.md index 8ac1a36de..d2d0b7485 100644 --- a/CardEmulation/Readme.md +++ b/CardEmulation/Readme.md @@ -1,19 +1,29 @@ -CardEmulation Sample -==================== +--- +name: Xamarin.Android - CardEmulation Sample +description: This sample demonstrates the use of the new Host Card Emulation (HCE) APIs in Android 4.4 (KitKat). This sample also demonstrates how to declare an... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: cardemulation +--- +# CardEmulation Sample This sample demonstrates the use of the new Host Card Emulation (HCE) APIs in Android 4.4 (KitKat). This sample also demonstrates how to declare an Android service using C# attributes (CardService.cs) which will be automatically added to the AnroidManifest.xml. -Instructions -------------------- +## Instructions * In order to run this sample, you will need two NFC-capable physical devices. One with this project (CardEmulation) installed, and another with the CardReader sample installed. Run each on the device it was installed on, then place the backs of the two devices together in order to allow NFC communication to occur. -Build Requirements ------------- +## Build Requirements Download the latest version of Xamarin Studio. Open CardEmulation.sln in Xamarin Studio and either build or run the project. -Author ------- +![CardEmulation Sample application screenshot](Screenshots/Main - No Log.png "CardEmulation Sample application screenshot") + +## Author Copyright (c) 2005-2008, The Android Open Source Project Ported to Xamarin.Android by Christopher Blackman diff --git a/CardReader/README.md b/CardReader/README.md index f1797b1d2..84fadd9b1 100644 --- a/CardReader/README.md +++ b/CardReader/README.md @@ -1,16 +1,26 @@ -CardReader -===== +--- +name: Xamarin.Android - CardReader +description: This sample demonstrates how to implement a low-level NFC card reader, for reading cards that do not contain NDEF or Android Beam data. This sample... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: cardreader +--- +# CardReader This sample demonstrates how to implement a low-level NFC card reader, for reading cards that do not contain NDEF or Android Beam data. This sample is designed to read the virtual loyalty card implemented in the "CardEmulation" sample. -Instructions ------------- +## Instructions * In order to run this sample, you will need two NFC-capable physical devices. One with this project (CardEmulation) installed, and another with the CardReader sample installed. Run each on the device it was installed on, then place the backs of the two devices together in order to allow NFC communication to occur. -Build Requirements ------------------- +## Build Requirements Download the latest version of Xamarin Studio. Open CardReader.sln in Xamarin Studio and either build or run the project. This project requires the API level 19 SDK platform. -Author ------- +![CardReader application screenshot](Screenshots/Screenshot_2014-07-14-13-58-56.png "CardReader application screenshot") + +## Author Copyright (c) 2005-2008, The Android Open Source Project Ported to Xamarin.Android by Sean Pearl diff --git a/CocosSharpEntities/README.md b/CocosSharpEntities/README.md index a87af9011..946538129 100644 --- a/CocosSharpEntities/README.md +++ b/CocosSharpEntities/README.md @@ -1,9 +1,19 @@ -Game Entities in CocosSharp -==================================== +--- +name: Xamarin.Android - Game Entities in CocosSharp +description: 'This project shows how to create game entities in CocosSharp by inheriting from CCNode. It includes two entities: Ship and Bullet' +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: cocossharpentities +--- +# Game Entities in CocosSharp This project shows how to create game entities in CocosSharp by inheriting from CCNode. It includes two entities: Ship and Bullet -Author ------- +## Author Victor Chelaru \ No newline at end of file diff --git a/ContactManager/README.md b/ContactManager/README.md index f784f1b42..28274518c 100644 --- a/ContactManager/README.md +++ b/ContactManager/README.md @@ -1,4 +1,15 @@ -Contact Manager -=============== +--- +name: Xamarin.Android - Contact Manager +description: This sample demonstrates how to interact with Android's contact manager. +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: contactmanager +--- +# Contact Manager This sample demonstrates how to interact with Android's contact manager. diff --git a/ContactsProviderDemo/README.md b/ContactsProviderDemo/README.md index 0d7e9a5ce..71ea7fae8 100644 --- a/ContactsProviderDemo/README.md +++ b/ContactsProviderDemo/README.md @@ -1,5 +1,16 @@ -ContactsProvider Demo -===================== +--- +name: Xamarin.Android - ContactsProvider Demo +description: This example shows how to use the ContactsProvider as well as the device owner's profile in Android. +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: contactsproviderdemo +--- +# ContactsProvider Demo This example shows how to use the `ContactsProvider` as well as the device owner's profile in Android. diff --git a/ContentProvider/README.md b/ContentProvider/README.md index dec7fabfe..30108e5ca 100644 --- a/ContentProvider/README.md +++ b/ContentProvider/README.md @@ -1,11 +1,23 @@ -Content Provider Demo -===================== +--- +name: Xamarin.Android - Content Provider Demo +description: Just a small example showing how a Content Provider can be implemented in Mono for Android. I used this article as reference. +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: contentprovider +--- +# Content Provider Demo Just a small example showing how a Content Provider can be implemented in Mono for Android. I used this [article](http://www.devx.com/wireless/Article/41133/1954) as reference. -Author ------- +![Content Provider Demo application screenshot](Screenshots/Output.png "Content Provider Demo application screenshot") + +## Author Tomasz Cielecki aka [Cheesebaron](https://github.com/Cheesebaron) diff --git a/CursorTableAdapter/README.md b/CursorTableAdapter/README.md index 24d8a5453..fa4836fd6 100644 --- a/CursorTableAdapter/README.md +++ b/CursorTableAdapter/README.md @@ -1,4 +1,15 @@ -Cursor Table Adapter -==================== +--- +name: Xamarin.Android - Cursor Table Adapter +description: This sample is part of the Android ListViews and Adapters series. +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: cursortableadapter +--- +# Cursor Table Adapter This sample is part of the Android ListViews and Adapters series. \ No newline at end of file diff --git a/CustomRowView/README.md b/CustomRowView/README.md index 23f07e7e9..c4cabff10 100644 --- a/CustomRowView/README.md +++ b/CustomRowView/README.md @@ -1,4 +1,15 @@ -Custom Row Views -================ +--- +name: Xamarin.Android - Custom Row Views +description: This sample is part of the Android ListViews and Adapters series. +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: customrowview +--- +# Custom Row Views This sample is part of the Android ListViews and Adapters series. \ No newline at end of file diff --git a/CustomTransitions/README.md b/CustomTransitions/README.md index 78d67a19c..69ff8b91d 100644 --- a/CustomTransitions/README.md +++ b/CustomTransitions/README.md @@ -1,17 +1,27 @@ -Custom Transitions -================== +--- +name: Xamarin.Android - Custom Transitions +description: This sample demonstrates how to create custom transitions to go from one scene in their app to the next. The transition created in this sample... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: customtransitions +--- +# Custom Transitions This sample demonstrates how to create custom transitions to go from one scene in their app to the next. The transition created in this sample smoothly changes between three scenes which each have three colored boxes with the colors in a different order in each scene. -Instructions ------------- +## Instructions * Press the "Show next scene" button to cycle the colors using a custom transition. * Press the "Show Log" button to show what is logged as the transitions occur -Build Requirements ------------------- +## Build Requirements This sample requires the SDK platform level 19 to build and a device that is level 19 or newer to run. -Author ------- +![Custom Transitions application screenshot](Screenshots/Screenshot_2014-07-03-15-58-07.png "Custom Transitions application screenshot") + +## Author Copyright (c) 2005-2008, The Android Open Source Project Ported to Xamarin.Android by John Pilczak diff --git a/DynamicTest/README.md b/DynamicTest/README.md index cacfa8064..16014d01c 100644 --- a/DynamicTest/README.md +++ b/DynamicTest/README.md @@ -1,5 +1,16 @@ -C# Dynamic Test -=============== +--- +name: Xamarin.Android - C# Dynamic Test +description: This samples makes use of dynamic types in DLR. This sample imports System.Json from ASP.NET MVC sources which includes JsonValue.AsDynamic() which... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: dynamictest +--- +# C# Dynamic Test This samples makes use of dynamic types in DLR. This sample imports System.Json from ASP.NET MVC sources which includes JsonValue.AsDynamic() diff --git a/Example_WorkingWithAudio/README.md b/Example_WorkingWithAudio/README.md index cafe601f0..40d72ce13 100644 --- a/Example_WorkingWithAudio/README.md +++ b/Example_WorkingWithAudio/README.md @@ -1,8 +1,24 @@ -Working With Audio – Test Application -===================================== +--- +name: Xamarin.Android - Working With Audio – Test Application +description: 'Sample code to accompany the article Working With Audio. This simple application provides the following functionality: Recording audio using the...' +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: example-workingwithaudio +--- +# Working With Audio – Test Application -Sample code to accompany the article Working With Audio. This simple application provides the following functionality: * Recording audio using the high-level API (MediaRecorder.) * Playing audio using the high-level API (MediaPlayer.) * Recording audio using the low-level API (AudioRecord.) * Playing audio using the low-level API (AudioTrack.) * Optionally use Audio notifications. - One can only play back what has been recorded in the same session. (For this reason, the playback buttons are disabled on start-up.) - Once on operation has been started, it must be stopped. No other actions are allowed in the meantime. - The best way to demonstrate recording and playback is to record some sound and then play it back again. - The best way to see audio notifications in action is to call the test phone, keep the call open for a while and then end the call while there is an ongoing operation. Audio-focus will be taken away and then granted again when the call is complete. \ No newline at end of file +Sample code to accompany the article Working With Audio. This simple application provides the following functionality: + +* Recording audio using the high-level API (MediaRecorder.) +* Playing audio using the high-level API (MediaPlayer.) +* Recording audio using the low-level API (AudioRecord.) +* Playing audio using the low-level API (AudioTrack.) +* Optionally use Audio notifications. + +One can only play back what has been recorded in the same session. (For this reason, the playback buttons are disabled on start-up.) +Once on operation has been started, it must be stopped. No other actions are allowed in the meantime. The best way to demonstrate recording and playback is to record some sound and then play it back again. The best way to see audio notifications in action is to call the test phone, keep the call open for a while and then end the call while there is an ongoing operation. Audio-focus will be taken away and then granted again when the call is complete. diff --git a/ExportAttribute/README.md b/ExportAttribute/README.md index 0297fe1c9..bb4e6266c 100644 --- a/ExportAttribute/README.md +++ b/ExportAttribute/README.md @@ -1,11 +1,21 @@ -ExportAttributeTest -=================== +--- +name: Xamarin.Android - ExportAttributeTest +description: This is a functional test for ExportAttribute which is new in Mono for Android 4.2. This contains sample code for android:onClick,... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: exportattribute +--- +# ExportAttributeTest This is a functional test for "ExportAttribute" which is new in Mono for Android 4.2. This contains sample code for android:onClick, java.io.Serializable and android.os.Parcelable. -Authors -------- +## Authors Atsushi Eno (C# port) diff --git a/Facebook/README.md b/Facebook/README.md index b79db1577..1a98e5c89 100644 --- a/Facebook/README.md +++ b/Facebook/README.md @@ -1,8 +1,18 @@ -How to build the entire package from source -=========================================== - -Prerequisites -------------- +--- +name: Xamarin.Android - How to build the entire package from source +description: Prerequisites - Android SDK. - Environment variable ANDROIDHOME/path/to/the/sdk - Environment variable PATH must contain $ANDROIDHOME/tools -... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: facebook +--- +# How to build the entire package from source + +## Prerequisites - Android SDK. - Environment variable ANDROID_HOME=/path/to/the/sdk @@ -11,8 +21,7 @@ Prerequisites - Apache Ant to build the library project zip. - Apache Maven 3.0 to build the library in its own manner and then Javadoc. -Build steps ------------ +## Build steps Download Facebook Android SDK v3.0.1 from: https://developers.facebook.com/resources/facebook-android-sdk-3.0.1.zip diff --git a/FastScroll/README.md b/FastScroll/README.md index 1dff45bb8..086a199af 100644 --- a/FastScroll/README.md +++ b/FastScroll/README.md @@ -1,4 +1,15 @@ -Fast Scroll -============== +--- +name: Xamarin.Android - Fast Scroll +description: This sample is part of the Android ListViews and Adapters series. +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: fastscroll +--- +# Fast Scroll This sample is part of the Android ListViews and Adapters series. \ No newline at end of file diff --git a/FingerprintGuide/README.md b/FingerprintGuide/README.md index 0b437d082..e1b191568 100644 --- a/FingerprintGuide/README.md +++ b/FingerprintGuide/README.md @@ -1,5 +1,16 @@ -Fingerprint Sample -================== +--- +name: Xamarin.Android - Fingerprint Sample +description: This app is the companion code for the Android 6.0 Fingerprint Authentication guide. This is a sample application that demonstrations how the use... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: fingerprintguide +--- +# Fingerprint Sample This app is the companion code for the [Android 6.0 Fingerprint Authentication guide](http://developer.xamarin.com/guides/android/platform_features/fingerprint-authentication). diff --git a/Firebase/FCMNotifications/README.md b/Firebase/FCMNotifications/README.md index 11ebd86e4..0c9e92fa4 100644 --- a/Firebase/FCMNotifications/README.md +++ b/Firebase/FCMNotifications/README.md @@ -1,5 +1,16 @@ -Android FCM Remote Notifications -================================ +--- +name: Xamarin.Android - Android FCM Remote Notifications +description: This sample app accompanies the article Remote Notifications with Firebase Cloud Messaging. Before you can use this sample, you must acquire the... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: firebase-fcmnotifications +--- +# Android FCM Remote Notifications This sample app accompanies the article [Remote Notifications with Firebase Cloud Messaging](http://developer.xamarin.com/guides/android/application_fundamentals/notifications/remote-notifications-with-fcm/). @@ -16,8 +27,9 @@ observed by watching the output window while the app runs from the IDE. -Author ------- +![Android FCM Remote Notifications application screenshot](Screenshots/screenshot-1.png "Android FCM Remote Notifications application screenshot") + +## Author Copyright 2016 Xamarin diff --git a/FragmentTransition/README.md b/FragmentTransition/README.md index a735aea92..3544c7c50 100644 --- a/FragmentTransition/README.md +++ b/FragmentTransition/README.md @@ -1,5 +1,16 @@ -Fragment Transition -=================== +--- +name: Xamarin.Android - Fragment Transition +description: This sample demonstrates how to start a transition right after a fragment transaction. This allows for more fluid transitions and animations... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: fragmenttransition +--- +# Fragment Transition This sample demonstrates how to start a transition right after a fragment transaction. This allows for more fluid transitions and animations between different fragments such has holding a image in place as the fragment exits and then expand to it's new location/size. Note: This sample is not fluid on Android L Developer Preview. This problem exists for both the Monodroid port and the original Java sample from Google. Ported By: Ben O'Halloran \ No newline at end of file diff --git a/FragmentsWalkthrough/README.md b/FragmentsWalkthrough/README.md index fd2388eaa..bdb07744c 100755 --- a/FragmentsWalkthrough/README.md +++ b/FragmentsWalkthrough/README.md @@ -1,5 +1,16 @@ -Fragments Walkthrough -===================== +--- +name: Xamarin.Android - Fragments Walkthrough +description: This is the source code for the Fragments Walkthrough. +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: fragmentswalkthrough +--- +# Fragments Walkthrough This is the source code for the [Fragments Walkthrough](http://developer.xamarin.com/guides/android/platform_features/fragments/fragments_walkthrough/). diff --git a/FrameAnimation/README.md b/FrameAnimation/README.md index be20f3b77..5e5268509 100644 --- a/FrameAnimation/README.md +++ b/FrameAnimation/README.md @@ -1,5 +1,16 @@ -FrameAnimation -============== +--- +name: Xamarin.Android - FrameAnimation +description: This solution is the source code for the FrameAnimation recipe. It demonstrates how to perform a simple frame animation in Android. +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: frameanimation +--- +# FrameAnimation This solution is the source code for the [FrameAnimation recipe](http://developer.xamarin.com/recipes/android/other_ux/animation/frame_animation/). diff --git a/FusedLocationProvider/README.md b/FusedLocationProvider/README.md index 5d4489c6f..cd13ce31e 100644 --- a/FusedLocationProvider/README.md +++ b/FusedLocationProvider/README.md @@ -1,5 +1,16 @@ -FusedLocationProvider Sample -================================ +--- +name: Xamarin.Android - FusedLocationProvider Sample +description: This sample provides an example of gathering location data using the FusedLocationProvider, available as part of Google Play services. A detailed... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: fusedlocationprovider +--- +# FusedLocationProvider Sample This sample provides an example of gathering location data using the FusedLocationProvider, available as part of Google Play services. A detailed diff --git a/GLCube-1.0/README.md b/GLCube-1.0/README.md index 897c44a34..09c02434e 100644 --- a/GLCube-1.0/README.md +++ b/GLCube-1.0/README.md @@ -1,9 +1,19 @@ -GL Rotating Cube -================ +--- +name: Xamarin.Android - GL Rotating Cube +description: This sample demonstrates simple drawing via OpenTK's GL APIs by drawing a rotating cube. See Also GLCube +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: glcube-10 +--- +# GL Rotating Cube This sample demonstrates simple drawing via OpenTK's GL APIs by drawing a rotating cube. -See Also --------- +## See Also * [GLCube](https://github.com/xamarin/monodroid-samples/tree/master/GLCube) diff --git a/GLCube/README.md b/GLCube/README.md index 1c5b5ee74..97db1d361 100644 --- a/GLCube/README.md +++ b/GLCube/README.md @@ -1,5 +1,16 @@ -GL Rotating Cube -================ +--- +name: Xamarin.Android - GL Rotating Cube +description: This sample is now obsolete. Please use GLCube-1.0. This sample demonstrates simple drawing via OpenTK's GL APIs by drawing a rotating cube. +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: glcube +--- +# GL Rotating Cube ### This sample is now obsolete. Please use GLCube-1.0. diff --git a/GLDiagnostics-1.0/README.md b/GLDiagnostics-1.0/README.md index f8bc9794a..de299f336 100644 --- a/GLDiagnostics-1.0/README.md +++ b/GLDiagnostics-1.0/README.md @@ -1,9 +1,19 @@ -GL Diagnostics -============== +--- +name: Xamarin.Android - GL Diagnostics +description: This sample tests all possible graphics configuration options and outputs valid ones. See Also GLDiagnostics +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: gldiagnostics-10 +--- +# GL Diagnostics This sample tests all possible graphics configuration options and outputs valid ones. -See Also -------- +## See Also * [GLDiagnostics](https://github.com/xamarin/monodroid-samples/tree/master/GLDiagnostics) diff --git a/GLDiagnostics/README.md b/GLDiagnostics/README.md index e11204a2f..bdfab138a 100644 --- a/GLDiagnostics/README.md +++ b/GLDiagnostics/README.md @@ -1,5 +1,16 @@ -GL Diagnostics -============== +--- +name: Xamarin.Android - GL Diagnostics +description: This sample is now obsolete. Please use GLDiagnostics-1.0. This sample tests all possible graphics configuration options and outputs valid ones. +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: gldiagnostics +--- +# GL Diagnostics ### This sample is now obsolete. Please use GLDiagnostics-1.0. diff --git a/GLDiagnostics30/README.md b/GLDiagnostics30/README.md index adb64d8f9..abcf90892 100644 --- a/GLDiagnostics30/README.md +++ b/GLDiagnostics30/README.md @@ -1,5 +1,16 @@ -GL Diagnostics -============== +--- +name: Xamarin.Android - GL Diagnostics +description: This sample tests all possible graphics configuration options and outputs valid ones. +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: gldiagnostics30 +--- +# GL Diagnostics This sample tests all possible graphics configuration options and outputs valid ones. diff --git a/GLTriangle20-1.0/README.md b/GLTriangle20-1.0/README.md index cb60fa1ed..8a52f8ca2 100644 --- a/GLTriangle20-1.0/README.md +++ b/GLTriangle20-1.0/README.md @@ -1,10 +1,20 @@ -GL Triangle 20 -============== +--- +name: Xamarin.Android - GL Triangle 20 +description: 'OpenGL ES 2.0 Demonstration. Requirements There is one requirement to run this sample: 1. A device with OpenGL ES 2.0 support. Note that emulators...' +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: gltriangle20-10 +--- +# GL Triangle 20 OpenGL ES 2.0 Demonstration. -Requirements ------------- +## Requirements There is one requirement to run this sample: diff --git a/GLTriangle20/README.md b/GLTriangle20/README.md index c530b6b47..e507fb457 100644 --- a/GLTriangle20/README.md +++ b/GLTriangle20/README.md @@ -1,12 +1,22 @@ -GL Triangle 20 -============== +--- +name: Xamarin.Android - GL Triangle 20 +description: 'This sample is now obsolete. Please use GLTriangle20-1.0. OpenGL ES 2.0 Demonstration. Requirements There is one requirement to run this sample: 1....' +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: gltriangle20 +--- +# GL Triangle 20 ### This sample is now obsolete. Please use GLTriangle20-1.0. OpenGL ES 2.0 Demonstration. -Requirements ------------- +## Requirements There is one requirement to run this sample: diff --git a/GLTriangle30/README.md b/GLTriangle30/README.md index 0769405db..aea73336e 100644 --- a/GLTriangle30/README.md +++ b/GLTriangle30/README.md @@ -1,10 +1,20 @@ -GL Triangle 30 -============== +--- +name: Xamarin.Android - GL Triangle 30 +description: 'OpenTK 3.0 version of GLTriangle Requirements There is one requirement to run this sample: 1. A device with OpenGL ES 3.0 support. Note that...' +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: gltriangle30 +--- +# GL Triangle 30 OpenTK 3.0 version of GLTriangle -Requirements ------------- +## Requirements There is one requirement to run this sample: @@ -13,7 +23,6 @@ There is one requirement to run this sample: Note that emulators targeting API levels 1 through 13 provide only OpenGL ES 1.0 support, not 2.0. -See Also ----- +## See Also * [GLTriangle20](https://github.com/xamarin/monodroid-samples/tree/master/GLTriangle20) * [GLTriangle20-1.0](https://github.com/xamarin/monodroid-samples/tree/master/GLTriangle20-1.0) diff --git a/GestureBuilder/README.md b/GestureBuilder/README.md index c5642d68e..46c3800c5 100644 --- a/GestureBuilder/README.md +++ b/GestureBuilder/README.md @@ -1,11 +1,21 @@ -GestureBuilder -============== +--- +name: Xamarin.Android - GestureBuilder +description: This is a port of Android SDK sample GestureBuilder which is a showcase for android.gesture API. +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: gesturebuilder +--- +# GestureBuilder This is a port of Android SDK sample "GestureBuilder" which is a showcase for android.gesture API. -Authors -------- +## Authors Android Open Source Project (original Java) Atsushi Eno (C# port) diff --git a/GooglePlayServices/README.md b/GooglePlayServices/README.md index 0fb0db6c1..975882bf1 100644 --- a/GooglePlayServices/README.md +++ b/GooglePlayServices/README.md @@ -1,5 +1,16 @@ -Google Play Services -==================== +--- +name: Xamarin.Android - Google Play Services +description: This solution uses the Xamarin Google Play Services NuGet to demonstrate a few uses of the maps API included within Google Play Services. You will... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: googleplayservices +--- +# Google Play Services This solution uses the Xamarin Google Play Services NuGet to demonstrate a few uses of the maps API included within Google Play Services. diff --git a/GridLayoutDemo/README.md b/GridLayoutDemo/README.md index 9031e05c1..79fee88a4 100644 --- a/GridLayoutDemo/README.md +++ b/GridLayoutDemo/README.md @@ -1,4 +1,15 @@ -GridLayout Demo -=============== +--- +name: Xamarin.Android - GridLayout Demo +description: This example shows how to use a GridLayout with Ice Cream Sandwich. +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: gridlayoutdemo +--- +# GridLayout Demo This example shows how to use a GridLayout with Ice Cream Sandwich. diff --git a/HelloM4A/README.md b/HelloM4A/README.md index 504b73440..a39e7c168 100644 --- a/HelloM4A/README.md +++ b/HelloM4A/README.md @@ -1,5 +1,16 @@ -Hello Mono for Android -====================== +--- +name: Xamarin.Android - Hello Mono for Android +description: This is a super simple hello world application. It displays a message in a TextView when a Button is pressed. +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: hellom4a +--- +# Hello Mono for Android This is a super simple hello world application. It displays a message in a TextView when a Button is pressed. diff --git a/HelloMultiScreen/README.md b/HelloMultiScreen/README.md index a87c2d401..c19f9c9ed 100644 --- a/HelloMultiScreen/README.md +++ b/HelloMultiScreen/README.md @@ -1,4 +1,15 @@ -Hello Multiscreen -================= +--- +name: Xamarin.Android - Hello Multiscreen +description: This is a simple example showing how to use activities to create multiscreen applications. +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: hellomultiscreen +--- +# Hello Multiscreen This is a simple example showing how to use activities to create multiscreen applications. diff --git a/HelloTabsICS/README.md b/HelloTabsICS/README.md index 0b59c529e..d3b4af25c 100644 --- a/HelloTabsICS/README.md +++ b/HelloTabsICS/README.md @@ -1,4 +1,15 @@ -ICS Tabs Demo -============= +--- +name: Xamarin.Android - ICS Tabs Demo +description: This example shows how to use tabs from the Action Bar in Ice Cream Sandwich. +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: hellotabsics +--- +# ICS Tabs Demo This example shows how to use tabs from the Action Bar in Ice Cream Sandwich. diff --git a/HelloWorld/README.md b/HelloWorld/README.md index 98ec0a53d..b4f8bfa7a 100644 --- a/HelloWorld/README.md +++ b/HelloWorld/README.md @@ -1,5 +1,16 @@ -Hello World -=========== +--- +name: Xamarin.Android - Hello World +description: This is a super simple hello world application. It uses a TextView to display a plain old hello world message via a string resource. +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: helloworld +--- +# Hello World This is a super simple hello world application. It uses a TextView to display a plain old hello world message via a string resource. diff --git a/HelloWorldPublishing/README.md b/HelloWorldPublishing/README.md index d70662f3c..30f160284 100644 --- a/HelloWorldPublishing/README.md +++ b/HelloWorldPublishing/README.md @@ -1,5 +1,16 @@ -Hello World (Publishing) -======================== +--- +name: Xamarin.Android - Hello World (Publishing) +description: This is a simple hello world type application to that goes along with the Xamarin topic Publishing an Application. This project contains a sample... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: helloworldpublishing +--- +# Hello World (Publishing) This is a simple hello world type application to that goes along with the Xamarin topic diff --git a/HoneycombGallery/README.md b/HoneycombGallery/README.md index b2f83049b..65ae9f3db 100644 --- a/HoneycombGallery/README.md +++ b/HoneycombGallery/README.md @@ -1,5 +1,16 @@ -Honeycomb Gallery -================= +--- +name: Xamarin.Android - Honeycomb Gallery +description: This is a port of Android SDK samples. It demonstrates a couple of new APIs in Honeycomb e.g. fragments, ActionBar and the new animation framework. +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: honeycombgallery +--- +# Honeycomb Gallery This is a port of Android SDK samples. diff --git a/HowsMyTls/README.md b/HowsMyTls/README.md index 5c7bed8f1..b8e0c7fa2 100644 --- a/HowsMyTls/README.md +++ b/HowsMyTls/README.md @@ -1,5 +1,16 @@ -How's my TLS? -============= +--- +name: Xamarin.Android - How's my TLS? +description: 'This sample demonstrates how to make a basic TLS connection using different classes availbale for Xamarin.Android developers: HttpWebRequest +...' +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: howsmytls +--- +# How's my TLS? This sample demonstrates how to make a basic TLS connection using different classes availbale for Xamarin.Android developers: * `HttpWebRequest` + `WebResponce` - doesn't have support of TLSv1.2, maximum version of supported TLS is 1.0 diff --git a/JavaIntegration/AarBinding/README.md b/JavaIntegration/AarBinding/README.md index 6c0a44f8f..2c18f50e4 100644 --- a/JavaIntegration/AarBinding/README.md +++ b/JavaIntegration/AarBinding/README.md @@ -1,5 +1,16 @@ -Binding an .AAR Example -======================= +--- +name: Xamarin.Android - Binding an .AAR Example +description: This sample app accompanies the article, Binding an .AAR. This sample can help you understand how a Xamarin.Android application can reuse existing... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: javaintegration-aarbinding +--- +# Binding an .AAR Example This sample app accompanies the article, [Binding an .AAR](http://developer.xamarin.com/guides/android/advanced_topics/java_integration_overview/binding-a-java-library/binding-an-aar/). @@ -23,8 +34,9 @@ is the Binding Project that wraps the `textanalyzer.aar` file, and the `BindingTest` project is the test app that references `AarBinding`. -Author ------- +![Binding an .AAR Example application screenshot](Screenshots/initial-screen.png "Binding an .AAR Example application screenshot") + +## Author Mark McLemore diff --git a/JetBoy/README.md b/JetBoy/README.md index eba88843f..40c79fdd9 100644 --- a/JetBoy/README.md +++ b/JetBoy/README.md @@ -1,4 +1,15 @@ -Jet Boy -======= +--- +name: Xamarin.Android - Jet Boy +description: A simple game demonstrating usage of the JET audio engine. +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: jetboy +--- +# Jet Boy A simple game demonstrating usage of the JET audio engine. diff --git a/JniDemo/README.md b/JniDemo/README.md index 8a2209ebd..87f1c26a4 100644 --- a/JniDemo/README.md +++ b/JniDemo/README.md @@ -1,11 +1,21 @@ -Java Native Invoke Sample -========================= +--- +name: Xamarin.Android - Java Native Invoke Sample +description: This sample shows how to manually bind to a Java library so it can be consumed by a Mono for Android application. Requirements There is one... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: jnidemo +--- +# Java Native Invoke Sample This sample shows how to manually bind to a Java library so it can be consumed by a Mono for Android application. -Requirements ------------- +## Requirements There is one requirement in order to build and run this sample: @@ -15,8 +25,7 @@ Commands that need to be executed are indicated within backtics (`), and $ANDROID_SDK_PATH is the directory that contains your Android SDK installation. -How it works ------------- +## How it works As Mono for Android 1.0 does not support binding arbitrary .jar files (only the Android SDK android.jar is bound), alternative diff --git a/KitKat/README.md b/KitKat/README.md index 7fd4dcb31..374c95ea4 100644 --- a/KitKat/README.md +++ b/KitKat/README.md @@ -1,5 +1,16 @@ -KitKat -====== +--- +name: Xamarin.Android - KitKat +description: 'This sample provides an overview of new features of Android 4.4 KitKat. Features include: - User Interface: basic property animations and Scenes. -...' +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: kitkat +--- +# KitKat This sample provides an overview of new features of Android 4.4 "KitKat". Features include: - *User Interface*: basic property animations and Scenes. diff --git a/LabelledSections/README.md b/LabelledSections/README.md index 5c5fcc241..dbc2f1ef2 100644 --- a/LabelledSections/README.md +++ b/LabelledSections/README.md @@ -1,5 +1,16 @@ -Labelled Sections -================= +--- +name: Xamarin.Android - Labelled Sections +description: The Labelled Sections demo is a port from the Alphabetically ordered ListView with labelled sections sample, with some changes to follow .NET... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: labelledsections +--- +# Labelled Sections The `Labelled Sections` demo is a port from the [Alphabetically ordered ListView with labelled sections](http://androidseverywhere.info/JAAB/?p=6) diff --git a/LeaderboardsAndAchievementsDemo/README.md b/LeaderboardsAndAchievementsDemo/README.md index 8ffa563e7..9e2c278f1 100644 --- a/LeaderboardsAndAchievementsDemo/README.md +++ b/LeaderboardsAndAchievementsDemo/README.md @@ -1,5 +1,16 @@ -LeaderboardsAndAchievementsDemo -=============================== +--- +name: Xamarin.Android - LeaderboardsAndAchievementsDemo +description: This is a sample xamarin android application that shows the Leaderboards and Achievements for a specific provided game of Google Play Games. Setup... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: leaderboardsandachievementsdemo +--- +# LeaderboardsAndAchievementsDemo This is a sample xamarin android application that shows the [Leaderboards](https://developers.google.com/games/services/android/leaderboards) and [Achievements](https://developers.google.com/games/services/android/achievements) for a specific provided game of Google Play Games. @@ -25,7 +36,6 @@ For more information, please visit this [web site](https://developers.google.com ![screenshot](Screenshots/achievements.png "Achievements") -Author -------- +## Author Gonzalo Martin diff --git a/LifecycleDemo/README.md b/LifecycleDemo/README.md index 6105b243d..5ffbbf91c 100755 --- a/LifecycleDemo/README.md +++ b/LifecycleDemo/README.md @@ -1,5 +1,16 @@ -Android Lifecycle Demo -====================== +--- +name: Xamarin.Android - Android Lifecycle Demo +description: This sample app accompanies the article, Backgrounding. ![](Screenshots/example-screenshot.png) +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: lifecycledemo +--- +# Android Lifecycle Demo This sample app accompanies the article, [Backgrounding](http://developer.xamarin.com/guides/android/application_fundamentals/backgrounding/). diff --git a/LiveWallpaperDemo/README.md b/LiveWallpaperDemo/README.md index 2aa57e8fe..5780df712 100644 --- a/LiveWallpaperDemo/README.md +++ b/LiveWallpaperDemo/README.md @@ -1,5 +1,16 @@ -Live Wallpaper Demo -=================== +--- +name: Xamarin.Android - Live Wallpaper Demo +description: 'This sample demonstrates various forms of live wallpapers: A live Google Maps wallpaper. A rotating cube. A resource-based rotating cube and...' +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: livewallpaperdemo +--- +# Live Wallpaper Demo This sample demonstrates various forms of live wallpapers: @@ -7,8 +18,7 @@ This sample demonstrates various forms of live wallpapers: * A rotating cube. * A resource-based rotating cube and dodecahedron. -To Run -====== +# To Run * Deploy to target device using Build -> Deploy * Long tap on the desktop diff --git a/LoadingLargeBitmaps/README.md b/LoadingLargeBitmaps/README.md index 3250d997d..e8ce6ac32 100644 --- a/LoadingLargeBitmaps/README.md +++ b/LoadingLargeBitmaps/README.md @@ -1,5 +1,16 @@ -Loading Large Images -==================== +--- +name: Xamarin.Android - Loading Large Images +description: This is a sample project that shows how to efficiently resample large images before displaying them in an Android application. The images can be... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: loadinglargebitmaps +--- +# Loading Large Images This is a sample project that shows how to efficiently resample large images before displaying them in an Android application. The images can be reduced in size which will require less RAM one the device. diff --git a/LocalFiles/README.md b/LocalFiles/README.md index 91332be29..f53d21bd5 100644 --- a/LocalFiles/README.md +++ b/LocalFiles/README.md @@ -1,5 +1,16 @@ -Local Files -========= +--- +name: Xamarin.Android - Local Files +description: This sample app accompanies the guide, [](). It demonstrates reading and writing to a text file using Xamarin.Android and also demonstrates... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: localfiles +--- +# Local Files This sample app accompanies the guide, [](). It demonstrates reading and writing to a text file using Xamarin.Android and also demonstrates diff --git a/LocalNotifications/README.md b/LocalNotifications/README.md index 9653a67cb..0f39921e5 100644 --- a/LocalNotifications/README.md +++ b/LocalNotifications/README.md @@ -1,5 +1,16 @@ -Android Local Notifications Sample -================================== +--- +name: Xamarin.Android - Android Local Notifications Sample +description: This sample app accompanies the article, Walkthrough - Using Local Notifications in Xamarin.Android. ![](Screenshots/screenshots.png) When you tap... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: localnotifications +--- +# Android Local Notifications Sample This sample app accompanies the article, [Walkthrough - Using Local Notifications in Xamarin.Android](http://developer.xamarin.com/guides/cross-platform/application_fundamentals/notifications/android/local_notifications_in_android_walkthrough/). diff --git a/Location/README.md b/Location/README.md index b424295d9..ef1634a1c 100644 --- a/Location/README.md +++ b/Location/README.md @@ -1,5 +1,16 @@ -Android Location Services Sample -================================ +--- +name: Xamarin.Android - Android Location Services Sample +description: This sample provides an example of gathering location data using the Android location system service, as explained in the Xamarin Location Services... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: location +--- +# Android Location Services Sample This sample provides an example of gathering location data using the Android location system service, as explained in the [Xamarin Location Services](https://developer.xamarin.com/guides/android/platform_features/maps_and_location/location/) guide. diff --git a/MapsAndLocationDemo_v3/README.md b/MapsAndLocationDemo_v3/README.md index 548a72b69..72d3acf63 100755 --- a/MapsAndLocationDemo_v3/README.md +++ b/MapsAndLocationDemo_v3/README.md @@ -1,5 +1,16 @@ -Google Maps v2 Demo -=================== +--- +name: Xamarin.Android - Google Maps v2 Demo +description: This code provides an example of how to use Google Maps v2 in an Android application. The SimpleMapDemo project demonstrates the basic features of... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: mapsandlocationdemo-v3 +--- +# Google Maps v2 Demo This code provides an example of how to use Google Maps v2 in an Android application. The **SimpleMapDemo** project demonstrates the diff --git a/ModelAndVerts/README.md b/ModelAndVerts/README.md index 7c7dcd729..ec49266b7 100644 --- a/ModelAndVerts/README.md +++ b/ModelAndVerts/README.md @@ -1,11 +1,21 @@ -MonoGame Project Combining Model and Vertex Drawing for Android -==================================== +--- +name: Xamarin.Android - MonoGame Project Combining Model and Vertex Drawing for Android +description: 'This project shows how to combine Model rendering with vertex array rendering in MonoGame. This single solution contains two projects: one for...' +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: modelandverts +--- +# MonoGame Project Combining Model and Vertex Drawing for Android This project shows how to combine Model rendering with vertex array rendering in MonoGame. This single solution contains two projects: one for Android and one cross-platform portable class library. It is the result of the Working with Vertex Array in MonoGame walkthrough. -Author ------- +## Author Victor Chelaru \ No newline at end of file diff --git a/ModelDrawing/README.md b/ModelDrawing/README.md index 399eb771f..98661a590 100644 --- a/ModelDrawing/README.md +++ b/ModelDrawing/README.md @@ -1,11 +1,23 @@ -MonoGame Model Drawing Project for Android -==================================== +--- +name: Xamarin.Android - MonoGame Model Drawing Project for Android +description: This project shows how to load a XNB file into a MonoGame Model instance. Once loaded the Model instance is drawn on-screen six times. It is the... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: modeldrawing +--- +# MonoGame Model Drawing Project for Android This project shows how to load a XNB file into a MonoGame Model instance. Once loaded the Model instance is drawn on-screen six times. It is the result of working through the MonoGame Model walkthrough. This single solution contains two projects: one for Android and one cross-platform portable class library. -Author ------- +![MonoGame Model Drawing Project for Android application screenshot](Screenshots/Screenshot1.png "MonoGame Model Drawing Project for Android application screenshot") + +## Author Victor Chelaru \ No newline at end of file diff --git a/MonoGame3DCamera/README.md b/MonoGame3DCamera/README.md index 776e53ff6..9ee54008c 100644 --- a/MonoGame3DCamera/README.md +++ b/MonoGame3DCamera/README.md @@ -1,11 +1,21 @@ -MonoGame Project with 3D Camera and Model Positioning and Orientation -==================================== +--- +name: Xamarin.Android - MonoGame Project with 3D Camera and Model Positioning and Orientation +description: This project extends the Model with Vertex-based drawing project to add a user-controlled camera and 3D Model movement/orientation. This single... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: monogame3dcamera +--- +# MonoGame Project with 3D Camera and Model Positioning and Orientation This project extends the Model with Vertex-based drawing project to add a user-controlled camera and 3D Model movement/orientation. This single solution contains two projects: one for Android and one cross-platform portable class library. It is the result of the 3D Coordinates and Camera project. -Author ------- +## Author Victor Chelaru \ No newline at end of file diff --git a/MonoIO/README.md b/MonoIO/README.md index b3b1000b0..438ec9469 100644 --- a/MonoIO/README.md +++ b/MonoIO/README.md @@ -1,10 +1,20 @@ -Google IO 2011 App in Mono for Android -================================= +--- +name: Xamarin.Android - Google IO 2011 App in Mono for Android +description: This is a port of the [Google IO 2011 Schedule App][1] - it only works on Android 2.2 to Android 4.0.3 and it is not a port of the Google IO 2012... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: monoio +--- +# Google IO 2011 App in Mono for Android This is a port of the [Google IO 2011 Schedule App][1] - it only works on Android 2.2 to Android 4.0.3 and it is not a port of the Google IO 2012 application. -License -======= +# License Copyright 2011 Google Copyright 2012 Xamarin Inc diff --git a/MultiResolution/README.md b/MultiResolution/README.md index 5bef0c0c6..827b807e7 100644 --- a/MultiResolution/README.md +++ b/MultiResolution/README.md @@ -1,5 +1,16 @@ -Multi-Resolution Graphics -========================= +--- +name: Xamarin.Android - Multi-Resolution Graphics +description: This sample demonstrates how to display scalable/stretchable graphics using proper size units such as scale-independent pixels (sp) and... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: multiresolution +--- +# Multi-Resolution Graphics This sample demonstrates how to display scalable/stretchable graphics using proper size units such as scale-independent pixels (sp) and diff --git a/NotePad-Mono.Data.Sqlite/Readme.md b/NotePad-Mono.Data.Sqlite/Readme.md index 2e2734d37..e86441c6b 100644 --- a/NotePad-Mono.Data.Sqlite/Readme.md +++ b/NotePad-Mono.Data.Sqlite/Readme.md @@ -1,5 +1,16 @@ -Notepad Sample (Mono.Sqlite) -============================ +--- +name: Xamarin.Android - Notepad Sample (Mono.Sqlite) +description: This sample shows a simple note taking application. This sample uses MFA's included Mono.Data.Sqlite. If you want to see a similar sample using... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: notepad-monodatasqlite +--- +# Notepad Sample (Mono.Sqlite) This sample shows a simple note taking application. This sample uses MFA's included Mono.Data.Sqlite. diff --git a/OneABIPerAPK/README.md b/OneABIPerAPK/README.md index f9c7715bd..cd29cf197 100644 --- a/OneABIPerAPK/README.md +++ b/OneABIPerAPK/README.md @@ -1,5 +1,16 @@ -OneABIPerAPK -============ +--- +name: Xamarin.Android - OneABIPerAPK +description: This solution will build a simple HelloWorld style of project. There will be three APK's built, one for each ABI. This solution demonstrates how to... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: oneabiperapk +--- +# OneABIPerAPK This solution will build a simple HelloWorld style of project. There will be three APK's built, one for each ABI. This solution demonstrates how to create a unique `android:versionCode` for each APK. diff --git a/OsmDroidBindingExample/README.md b/OsmDroidBindingExample/README.md index b08a95a46..0826b23fd 100644 --- a/OsmDroidBindingExample/README.md +++ b/OsmDroidBindingExample/README.md @@ -1,5 +1,16 @@ -OSMDroid Bindings for Xamarin.Android -===================================== +--- +name: Xamarin.Android - OSMDroid Bindings for Xamarin.Android +description: This is an example of how to create bindings for a .jar file using a Java Binding Project in Xamarin.Android. This example creates a binding for... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: osmdroidbindingexample +--- +# OSMDroid Bindings for Xamarin.Android This is an example of how to create bindings for a .jar file using a Java Binding Project in Xamarin.Android. This example creates a binding for [osmdroid](http://code.google.com/p/osmdroid/) - an alternative to Google Maps based on the [OpenStreetMap](http://www.openstreetmap.org). diff --git a/Phoneword/README.md b/Phoneword/README.md index 632f50749..7bf395a59 100644 --- a/Phoneword/README.md +++ b/Phoneword/README.md @@ -1,5 +1,16 @@ -Phoneword -========= +--- +name: Xamarin.Android - Phoneword +description: This sample app accompanies the article, Hello, Android (Quickstart). This version of Phoneword incorporates all of the functionality explained in... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: phoneword +--- +# Phoneword This sample app accompanies the article, [Hello, Android (Quickstart)](http://developer.xamarin.com/guides/android/getting_started/hello,android/hello,android_quickstart/). diff --git a/PhonewordMultiscreen/README.md b/PhonewordMultiscreen/README.md index c53ad5445..0e479048b 100644 --- a/PhonewordMultiscreen/README.md +++ b/PhonewordMultiscreen/README.md @@ -1,5 +1,16 @@ -Phoneword Multiscreen -===================== +--- +name: Xamarin.Android - Phoneword Multiscreen +description: This sample app accompanies the article, Hello, Android Multiscreen (Quickstart). This sample contains all of the sample code presented in this... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: phonewordmultiscreen +--- +# Phoneword Multiscreen This sample app accompanies the article, [Hello, Android Multiscreen (Quickstart)](http://developer.xamarin.com/guides/android/getting_started/hello,android_multiscreen/hello,android_multiscreen_quickstart/). diff --git a/PlatformFeatures/ContactsAdapterDemo/README.md b/PlatformFeatures/ContactsAdapterDemo/README.md index 55212168a..46acdb22d 100644 --- a/PlatformFeatures/ContactsAdapterDemo/README.md +++ b/PlatformFeatures/ContactsAdapterDemo/README.md @@ -1,4 +1,15 @@ -Contacts ContentProvider -================== +--- +name: Xamarin.Android - Contacts ContentProvider +description: Sample for Using the Contacts ContentProvider +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: platformfeatures-contactsadapterdemo +--- +# Contacts ContentProvider Sample for [Using the Contacts ContentProvider](http://developer.xamarin.com/guides/android/platform_features/intro_to_content_providers/part_2_-_using_the_contacts_contentprovier/) diff --git a/PlatformFeatures/ICS_Samples/GridLayoutDemo/README.md b/PlatformFeatures/ICS_Samples/GridLayoutDemo/README.md index cb67abf75..e24094992 100644 --- a/PlatformFeatures/ICS_Samples/GridLayoutDemo/README.md +++ b/PlatformFeatures/ICS_Samples/GridLayoutDemo/README.md @@ -1,5 +1,16 @@ -Grid Layout Demo -================ +--- +name: Xamarin.Android - Grid Layout Demo +description: This sample app accompanies the article, GridLayout. +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: platformfeatures-ics-samples-gridlayoutdemo +--- +# Grid Layout Demo This sample app accompanies the article, [GridLayout](http://developer.xamarin.com/guides/android/user_interface/gridlayout/). diff --git a/PlatformFeatures/ICS_Samples/PopupMenuDemo/README.md b/PlatformFeatures/ICS_Samples/PopupMenuDemo/README.md index b44144301..5b6b9a6c4 100644 --- a/PlatformFeatures/ICS_Samples/PopupMenuDemo/README.md +++ b/PlatformFeatures/ICS_Samples/PopupMenuDemo/README.md @@ -1,5 +1,16 @@ -Popup Menu Demo -================ +--- +name: Xamarin.Android - Popup Menu Demo +description: This sample app accompanies the article, PopUp Menus. +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: platformfeatures-ics-samples-popupmenudemo +--- +# Popup Menu Demo This sample app accompanies the article, [PopUp Menus](http://developer.xamarin.com/guides/android/user_interface/popup_menus/). diff --git a/PlatformFeatures/ICS_Samples/README.md b/PlatformFeatures/ICS_Samples/README.md index ebedfcb0e..a318ddab8 100644 --- a/PlatformFeatures/ICS_Samples/README.md +++ b/PlatformFeatures/ICS_Samples/README.md @@ -1,5 +1,16 @@ -Ice Cream Sandwich Samples -========================== +--- +name: Xamarin.Android - Ice Cream Sandwich Samples +description: This collection of sample apps accompanies the article, Introduction to Ice Cream Sandwich. +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: platformfeatures-ics-samples +--- +# Ice Cream Sandwich Samples This collection of sample apps accompanies the article, [Introduction to Ice Cream Sandwich](http://developer.xamarin.com/guides/android/platform_features/introduction_to_ice_cream_sandwich/). diff --git a/PlatformFeatures/ICS_Samples/SwitchDemo/README.md b/PlatformFeatures/ICS_Samples/SwitchDemo/README.md index 853ceb337..93f56aa76 100644 --- a/PlatformFeatures/ICS_Samples/SwitchDemo/README.md +++ b/PlatformFeatures/ICS_Samples/SwitchDemo/README.md @@ -1,5 +1,16 @@ -Switch Demo -=========== +--- +name: Xamarin.Android - Switch Demo +description: This sample app accompanies the article, Introduction to Switches. +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: platformfeatures-ics-samples-switchdemo +--- +# Switch Demo This sample app accompanies the article, [Introduction to Switches](http://developer.xamarin.com/guides/android/user_interface/intro_to_switches/). diff --git a/PlatformFeatures/ICS_Samples/SystemUIVisibilityDemo/README.md b/PlatformFeatures/ICS_Samples/SystemUIVisibilityDemo/README.md index deda181a8..857d3ba59 100644 --- a/PlatformFeatures/ICS_Samples/SystemUIVisibilityDemo/README.md +++ b/PlatformFeatures/ICS_Samples/SystemUIVisibilityDemo/README.md @@ -1,5 +1,16 @@ -System UI Visibility Demo -========================= +--- +name: Xamarin.Android - System UI Visibility Demo +description: This sample app accompanies the article, Navigation Bar. +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: platformfeatures-ics-samples-systemuivisibilitydemo +--- +# System UI Visibility Demo This sample app accompanies the article, [Navigation Bar](http://developer.xamarin.com/guides/android/user_interface/navigation_bar/). diff --git a/PlatformFeatures/SimpleContentProvider/README.md b/PlatformFeatures/SimpleContentProvider/README.md index efdfa1824..54ec7e4be 100644 --- a/PlatformFeatures/SimpleContentProvider/README.md +++ b/PlatformFeatures/SimpleContentProvider/README.md @@ -1,4 +1,15 @@ -SimpleContentProvider -================== +--- +name: Xamarin.Android - SimpleContentProvider +description: Sample for Creating a Custom ContentProvider +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: platformfeatures-simplecontentprovider +--- +# SimpleContentProvider Sample for [Creating a Custom ContentProvider](http://developer.xamarin.com/guides/android/platform_features/intro_to_content_providers/part_3_-_creating_a_custom_contentprovider/) diff --git a/PlatformFeatures/SpeechToText/README.md b/PlatformFeatures/SpeechToText/README.md index 052889884..29954dab5 100644 --- a/PlatformFeatures/SpeechToText/README.md +++ b/PlatformFeatures/SpeechToText/README.md @@ -1,5 +1,16 @@ -Speech to Text -================== +--- +name: Xamarin.Android - Speech to Text +description: Sample for Android Speech ![](Screenshots/SpeechToText.png) +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: platformfeatures-speechtotext +--- +# Speech to Text Sample for [Android Speech](http://developer.xamarin.com/guides/android/platform_features/speech/) diff --git a/PlatformFeatures/TextToSpeech/README.md b/PlatformFeatures/TextToSpeech/README.md index ce1995052..c4bc0b0ac 100644 --- a/PlatformFeatures/TextToSpeech/README.md +++ b/PlatformFeatures/TextToSpeech/README.md @@ -1,5 +1,16 @@ -Text to Speech -================== +--- +name: Xamarin.Android - Text to Speech +description: Sample for Android Speech ![](Screenshots/TextToSpeech.png) +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: platformfeatures-texttospeech +--- +# Text to Speech Sample for [Android Speech](http://developer.xamarin.com/guides/android/platform_features/speech/) diff --git a/PlatformFeatures/TimeAnimatorExample/README.md b/PlatformFeatures/TimeAnimatorExample/README.md index abd10c8ef..abc501f92 100644 --- a/PlatformFeatures/TimeAnimatorExample/README.md +++ b/PlatformFeatures/TimeAnimatorExample/README.md @@ -1,5 +1,16 @@ -Jelly Bean Time Animation -========================= +--- +name: Xamarin.Android - Jelly Bean Time Animation +description: This sample app accompanies the article, Introduction to Jelly Bean. +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: platformfeatures-timeanimatorexample +--- +# Jelly Bean Time Animation This sample app accompanies the article, [Introduction to Jelly Bean](http://developer.xamarin.com/guides/android/platform_features/introduction_to_jelly_bean/). diff --git a/PopupMenuDemo/README.md b/PopupMenuDemo/README.md index d1d39b40f..e02b9f98e 100755 --- a/PopupMenuDemo/README.md +++ b/PopupMenuDemo/README.md @@ -1,5 +1,16 @@ -Popup Menu Demo -=============== +--- +name: Xamarin.Android - Popup Menu Demo +description: PopupMenuDemo is a sample app that accompanies the article, PopUp Menu. It demonstrates how to add support for displaying popup menus that are... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: popupmenudemo +--- +# Popup Menu Demo **PopupMenuDemo** is a sample app that accompanies the article, [PopUp Menu](https://docs.microsoft.com/en-us/xamarin/android/user-interface/controls/popup-menu). diff --git a/RemoteNotifications/README.md b/RemoteNotifications/README.md index 1820601b7..542d8d49e 100755 --- a/RemoteNotifications/README.md +++ b/RemoteNotifications/README.md @@ -1,5 +1,16 @@ -Android GCM Remote Notifications -================================ +--- +name: Xamarin.Android - Android GCM Remote Notifications +description: This sample app accompanies the article Remote Notifications with Google Cloud Messaging. Before you can use this sample, you must acquire the... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: remotenotifications +--- +# Android GCM Remote Notifications This sample app accompanies the article [Remote Notifications with Google Cloud Messaging](http://developer.xamarin.com/guides/android/application_fundamentals/notifications/remote-notifications-with-gcm/). @@ -13,8 +24,9 @@ Most of the action takes place "behind the scenes", and is to be observed by watching the output window while the app runs from the IDE. -Author ------- +![Android GCM Remote Notifications application screenshot](Screenshots/notification.png "Android GCM Remote Notifications application screenshot") + +## Author Copyright 2016 Xamarin diff --git a/RotationDemo/README.md b/RotationDemo/README.md index 4ffcc9028..51ebf528a 100644 --- a/RotationDemo/README.md +++ b/RotationDemo/README.md @@ -1,5 +1,16 @@ -Rotation Demo -============= +--- +name: Xamarin.Android - Rotation Demo +description: This is the sample code for the article Handling Rotation. It shows various techniques for working with device orientation changes in Mono for... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: rotationdemo +--- +# Rotation Demo This is the sample code for the article Handling Rotation. diff --git a/SanAngeles_NDK/README.md b/SanAngeles_NDK/README.md index 114fc1417..35c46ff7a 100644 --- a/SanAngeles_NDK/README.md +++ b/SanAngeles_NDK/README.md @@ -1,5 +1,16 @@ -Mono San Angeles sample port -============================ +--- +name: Xamarin.Android - Mono San Angeles sample port +description: This is a port of Android NDK sample (sanangeles). http://developer.android.com/tools/sdk/ndk/index.htmlSamples This library sample is easily... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: sanangeles-ndk +--- +# Mono San Angeles sample port This is a port of Android NDK sample (sanangeles). http://developer.android.com/tools/sdk/ndk/index.html#Samples @@ -11,15 +22,13 @@ any jobject instances or JNIEnv instance in C code. There are **TWO** versions available: -1) C++ for Visual Studio 2015 (SanAngeles_NativeDebug) ---- +## 1) C++ for Visual Studio 2015 (SanAngeles_NativeDebug) Complete C++ source is built as part of the solution, which means you can debug the C++ code while running the Xamarin.Android project using **Visual Studio 2015**. -2) Pre-compiled (SanAngeles_NDK) ------ +## 2) Pre-compiled (SanAngeles_NDK) The project contains pre-compiled libsanangeles.so under libs directory (armeabi, armeabi-v7a and x86 are supported). You'll only debug the Xamarin.Android C# code with this example. diff --git a/SanityTests/README.md b/SanityTests/README.md index 6488ccf08..b0e33d88a 100644 --- a/SanityTests/README.md +++ b/SanityTests/README.md @@ -1,5 +1,16 @@ -Sanity Tests -============ +--- +name: Xamarin.Android - Sanity Tests +description: SanityTests is a hodgepodge of things to test various interactions, such as SQLite use, JNI use, P/Invoke use, SSL, compression, and all manner of... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: sanitytests +--- +# Sanity Tests SanityTests is a hodgepodge of things to test various interactions, such as SQLite use, JNI use, P/Invoke use, SSL, compression, and all diff --git a/SearchableDictionary/README.md b/SearchableDictionary/README.md index 89a223731..92baeeb65 100644 --- a/SearchableDictionary/README.md +++ b/SearchableDictionary/README.md @@ -1,5 +1,16 @@ -Searchable Dictionary v2 -======================== +--- +name: Xamarin.Android - Searchable Dictionary v2 +description: This is a port of the Android Searchable Dictionary v2 sample. It demonstrates using Android's search framework. +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: searchabledictionary +--- +# Searchable Dictionary v2 This is a port of the Android Searchable Dictionary v2 sample. diff --git a/SectionIndex/README.md b/SectionIndex/README.md index 6c2f78e36..61c983b7a 100644 --- a/SectionIndex/README.md +++ b/SectionIndex/README.md @@ -1,4 +1,15 @@ -Section Index -============= +--- +name: Xamarin.Android - Section Index +description: This sample is part of the Android ListViews and Adapters series. +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: sectionindex +--- +# Section Index This sample is part of the Android ListViews and Adapters series. \ No newline at end of file diff --git a/ShareActionProviderDemo/README.md b/ShareActionProviderDemo/README.md index 054496fc3..123326d8c 100644 --- a/ShareActionProviderDemo/README.md +++ b/ShareActionProviderDemo/README.md @@ -1,4 +1,15 @@ -ShareActionProvider Demo -======================== +--- +name: Xamarin.Android - ShareActionProvider Demo +description: This example shows how to use the ShareActionProvider to share an image using Ice Cream Sandwich. +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: shareactionproviderdemo +--- +# ShareActionProvider Demo This example shows how to use the ShareActionProvider to share an image using Ice Cream Sandwich. diff --git a/SimpleCursorTableAdapter/README.md b/SimpleCursorTableAdapter/README.md index 675d97e38..ab7fedb58 100644 --- a/SimpleCursorTableAdapter/README.md +++ b/SimpleCursorTableAdapter/README.md @@ -1,4 +1,15 @@ -Simple Cursor Table Adapter -=========================== +--- +name: Xamarin.Android - Simple Cursor Table Adapter +description: This sample is part of the Android ListViews and Adapters series. +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: simplecursortableadapter +--- +# Simple Cursor Table Adapter This sample is part of the Android ListViews and Adapters series. \ No newline at end of file diff --git a/SimpleWidget/README.md b/SimpleWidget/README.md index b57dbfb79..1d358bd41 100644 --- a/SimpleWidget/README.md +++ b/SimpleWidget/README.md @@ -1,11 +1,21 @@ -Simple Widget -============= +--- +name: Xamarin.Android - Simple Widget +description: This sample shows a simple widget which fetches the word of the day from Wiktionary. To Run Deploy to target device using Build -> Deploy Long tap... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: simplewidget +--- +# Simple Widget This sample shows a simple widget which fetches the word of the day from Wiktionary. -To Run -====== +# To Run * Deploy to target device using Build -> Deploy * Long tap on the desktop diff --git a/SkeletonApp/README.md b/SkeletonApp/README.md index a700acd7e..cdae1677c 100644 --- a/SkeletonApp/README.md +++ b/SkeletonApp/README.md @@ -1,5 +1,16 @@ -Skeleton App -============ +--- +name: Xamarin.Android - Skeleton App +description: This is a simple application with an EditText control and clear/back buttons, plus a custom picture. +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: skeletonapp +--- +# Skeleton App This is a simple application with an EditText control and clear/back buttons, plus a custom picture. diff --git a/Snake/README.md b/Snake/README.md index 635496706..58800e032 100644 --- a/Snake/README.md +++ b/Snake/README.md @@ -1,4 +1,15 @@ -Snake -===== +--- +name: Xamarin.Android - Snake +description: A plain old Snake game based on a TileView. +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: snake +--- +# Snake A plain old Snake game based on a TileView. diff --git a/SplashScreen/README.md b/SplashScreen/README.md index 5febf8c1d..14b9d4838 100755 --- a/SplashScreen/README.md +++ b/SplashScreen/README.md @@ -1,5 +1,16 @@ -Creating a Splash Screen -======================== +--- +name: Xamarin.Android - Creating a Splash Screen +description: This sample demonstrates one technique for creating a splash screen in a Xamarin.Android application. It is the companion code for the... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: splashscreen +--- +# Creating a Splash Screen This sample demonstrates one technique for creating a splash screen in a Xamarin.Android application. It is the companion code for the Xamarin.Android diff --git a/StorageClient/README.md b/StorageClient/README.md index 87217034b..928f6f42d 100644 --- a/StorageClient/README.md +++ b/StorageClient/README.md @@ -1,5 +1,16 @@ -Storage Client -================== +--- +name: Xamarin.Android - Storage Client +description: This sample demonstrates how to use the ACTIONOPENDOCUMENT intent to let users choose a file via the system's file browser. This intent allows a... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: storageclient +--- +# Storage Client This sample demonstrates how to use the ACTION_OPEN_DOCUMENT intent to let users choose a file via the system's file browser. This intent allows a client application to access a list of diff --git a/StorageProvider/README.md b/StorageProvider/README.md index 41ef6c2a6..4280a5b0e 100644 --- a/StorageProvider/README.md +++ b/StorageProvider/README.md @@ -1,5 +1,16 @@ -Storage Provider -================== +--- +name: Xamarin.Android - Storage Provider +description: This sample demonstrates how to use the DocumentsProvider API to manage documents and expose them to the Android system for sharing. The Storage... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: storageprovider +--- +# Storage Provider This sample demonstrates how to use the DocumentsProvider API to manage documents and expose them to the Android system for sharing. diff --git a/Supportv7/ActionBarCompat-ListPopupMenu/README.md b/Supportv7/ActionBarCompat-ListPopupMenu/README.md index 0b7154a11..bff583052 100644 --- a/Supportv7/ActionBarCompat-ListPopupMenu/README.md +++ b/Supportv7/ActionBarCompat-ListPopupMenu/README.md @@ -1,34 +1,42 @@ -ActionBarCompat ListPopupMenu Sample -========================== +--- +name: Xamarin.Android - ActionBarCompat ListPopupMenu Sample +description: This sample shows how to display a pop up menu using PopupMenu from the v7 appcompat library. Introduction This sample displays a list of items and... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: supportv7-actionbarcompat-listpopupmenu +--- +# ActionBarCompat ListPopupMenu Sample This sample shows how to display a pop up menu using PopupMenu from the v7 appcompat library. -Introduction ------------- +## Introduction This sample displays a list of items and for each item, an icon can be clicked. When it is clicked, a pop up menu is shown, placed below the item, using the PopupMenu from the v7 appcompat support library. The sample uses ListFragment from the v4 support library to display the list. It shows how to instantiate and display the PopupMenu, as well as how to use `SetOnMenuItemClickListener()` to process the user actions on the PopupMenu. -Instructions ------------- +## Instructions * Tap on any delicious cheese in the list * Observe a pop up menu being shown * Tap 'Remove' on pop up menu * Observe the delicious cheese being removed from the list -Build Requirements ------------------- +## Build Requirements Using this sample requires the Android SDK platform for Android 5.1 (API level 21). -Screenshots -------------- +## Screenshots Screenshot Screenshot -Authors -------- +![ActionBarCompat ListPopupMenu Sample application screenshot](Screenshots/1-popup.png "ActionBarCompat ListPopupMenu Sample application screenshot") + +## Authors Copyright (c) 2014 The Android Open Source Project, Inc. Ported from [Android ActionBarCompat-ListPopupMenu Sample](https://github.com/googlesamples/android-ActionBarCompat-ListPopupMenu) diff --git a/Supportv7/AppCompat/Toolbar/README.md b/Supportv7/AppCompat/Toolbar/README.md index d6cacdd86..af6ec1a40 100644 --- a/Supportv7/AppCompat/Toolbar/README.md +++ b/Supportv7/AppCompat/Toolbar/README.md @@ -1,23 +1,33 @@ -Support v7 Toolbar -============== +--- +name: Xamarin.Android - Support v7 Toolbar +description: Basic sample of replacing the ActionBar with the new Support v7 app compat Toolbar. Instructions Run the project Click on the Toolbar items to see... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: supportv7-appcompat-toolbar +--- +# Support v7 Toolbar Basic sample of replacing the ActionBar with the new Support v7 app compat Toolbar. -Instructions ------------- +## Instructions * Run the project * Click on the Toolbar items to see click handlers * Click photo to navigate to details page -Build Requirements ------------------- +## Build Requirements * Xamarin Studio 5.5+ * Xamarin Android 4.20+ * Android SDK with Android 5.0 -Author ------- +![Support v7 Toolbar application screenshot](Screenshots/Details.png "Support v7 Toolbar application screenshot") + +## Author Copyright 2014 Xamarin Created by James Montemagno diff --git a/Supportv7/Pallete/README.md b/Supportv7/Pallete/README.md index 901262871..fcf975356 100644 --- a/Supportv7/Pallete/README.md +++ b/Supportv7/Pallete/README.md @@ -1,23 +1,33 @@ -Support v7 Palette -============== +--- +name: Xamarin.Android - Support v7 Palette +description: Basic sample of custom theming your application with the Palette support library. Instructions Run the project Click on an item in the GridView to... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: supportv7-pallete +--- +# Support v7 Palette Basic sample of custom theming your application with the Palette support library. -Instructions ------------- +## Instructions * Run the project * Click on an item in the GridView to go to details page * Click Apply Palette to see palette generation -Build Requirements ------------------- +## Build Requirements * Xamarin Studio 5.5+ * Xamarin Android 4.20+ * Android SDK with Android 5.0 -Author ------- +![Support v7 Palette application screenshot](Screenshots/Palette1.png "Support v7 Palette application screenshot") + +## Author Copyright 2014 Xamarin Created by James Montemagno diff --git a/SvgAndroid/README.md b/SvgAndroid/README.md index cdd40ce9c..acd79199f 100644 --- a/SvgAndroid/README.md +++ b/SvgAndroid/README.md @@ -1,5 +1,16 @@ -svg-android binding -=================== +--- +name: Xamarin.Android - svg-android binding +description: 'It is a binding example for svg-android Java library. svg-android project is located at: http://code.google.com/p/svg-android/ svg-android is under...' +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: svgandroid +--- +# svg-android binding It is a binding example for svg-android Java library. svg-android project is located at: diff --git a/SwipeToRefresh/README.md b/SwipeToRefresh/README.md index e3c4546cf..80d9457b8 100644 --- a/SwipeToRefresh/README.md +++ b/SwipeToRefresh/README.md @@ -1,4 +1,15 @@ -Swipe to Refresh -================ +--- +name: Xamarin.Android - Swipe to Refresh +description: This sample demonstrates how to implement the swipe to refresh pattern using the support library SwipeRefreshLayout class. +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: swipetorefresh +--- +# Swipe to Refresh This sample demonstrates how to implement the swipe to refresh pattern using the support library `SwipeRefreshLayout` class. \ No newline at end of file diff --git a/SwitchDemo/README.md b/SwitchDemo/README.md index 24642734e..2321f64dc 100644 --- a/SwitchDemo/README.md +++ b/SwitchDemo/README.md @@ -1,4 +1,15 @@ -Switch Demo -=========== +--- +name: Xamarin.Android - Switch Demo +description: This example shows how to use a switch control with Ice Cream Sandwich. +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: switchdemo +--- +# Switch Demo This example shows how to use a switch control with Ice Cream Sandwich. diff --git a/SystemUIVisibilityDemo/README.md b/SystemUIVisibilityDemo/README.md index e45b0a829..3b5ed9e5b 100644 --- a/SystemUIVisibilityDemo/README.md +++ b/SystemUIVisibilityDemo/README.md @@ -1,4 +1,15 @@ -System UI Visibility Demo -========================= +--- +name: Xamarin.Android - System UI Visibility Demo +description: This example shows how to change the appearance of the Navigation Bar in Ice Cream Sandwich. +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: systemuivisibilitydemo +--- +# System UI Visibility Demo This example shows how to change the appearance of the Navigation Bar in Ice Cream Sandwich. diff --git a/TextSwitcher/README.md b/TextSwitcher/README.md index 5267d5ed5..091687e67 100644 --- a/TextSwitcher/README.md +++ b/TextSwitcher/README.md @@ -1,16 +1,27 @@ -TextSwitcher Sample -=================== +--- +name: Xamarin.Android - TextSwitcher Sample +description: This sample illustrates the use of a TextSwitcher to display animations for text changes. Build Requirements Using this sample requires the Android... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: textswitcher +--- +# TextSwitcher Sample This sample illustrates the use of a TextSwitcher to display animations for text changes. -Build Requirements ------------------- +## Build Requirements Using this sample requires the Android 8.0 (API 26) and the Xamarin.Android 7.5.x or higher. -Authors -------- +![TextSwitcher Sample application screenshot](Screenshots/Home.png "TextSwitcher Sample application screenshot") + +## Authors Copyright (c) 2016 The Android Open Source Project, Inc. Ported from [Android TextSwitcher Sample](https://github.com/googlesamples/android-TextSwitcher). Ported to Xamarin.Android by Gonzalo Martin. \ No newline at end of file diff --git a/TextureViewDemo/README.md b/TextureViewDemo/README.md index 9dfa53b85..5612310ee 100644 --- a/TextureViewDemo/README.md +++ b/TextureViewDemo/README.md @@ -1,5 +1,16 @@ -TextureView Demo -================ +--- +name: Xamarin.Android - TextureView Demo +description: This example shows how to use a TextureView with Ice Cream Sandwich. A device is required for this example as the TextureView uses hardware... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: textureviewdemo +--- +# TextureView Demo This example shows how to use a TextureView with Ice Cream Sandwich. diff --git a/TexturedCube-1.0/README.md b/TexturedCube-1.0/README.md index 1f0ef23c5..eb6994783 100644 --- a/TexturedCube-1.0/README.md +++ b/TexturedCube-1.0/README.md @@ -1,9 +1,19 @@ -GL Textured Cube -================ +--- +name: Xamarin.Android - GL Textured Cube +description: This sample demonstrates a rotating cube rendered with textures via OpenTK's GL APIs. See Also GLTexturedCube +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: texturedcube-10 +--- +# GL Textured Cube This sample demonstrates a rotating cube rendered with textures via OpenTK's GL APIs. -See Also --------- +## See Also * [GLTexturedCube](https://github.com/xamarin/monodroid-samples/tree/master/TexturedCube) diff --git a/TexturedCube/README.md b/TexturedCube/README.md index 11f643736..e3b564dda 100644 --- a/TexturedCube/README.md +++ b/TexturedCube/README.md @@ -1,5 +1,16 @@ -GL Textured Cube -================ +--- +name: Xamarin.Android - GL Textured Cube +description: This sample is now obsolete. Please use TexturedCube-1.0. This sample demonstrates a rotating cube rendered with textures via OpenTK's GL APIs. +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: texturedcube +--- +# GL Textured Cube ### This sample is now obsolete. Please use TexturedCube-1.0. diff --git a/TexturedCubeES30-1.0/README.md b/TexturedCubeES30-1.0/README.md index ca25947e2..f053c4485 100644 --- a/TexturedCubeES30-1.0/README.md +++ b/TexturedCubeES30-1.0/README.md @@ -1,5 +1,16 @@ -GL Textured Cube -================ +--- +name: Xamarin.Android - GL Textured Cube +description: This sample demonstrates a rotating cube rendered with textures via OpenTK's GL APIs. +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: texturedcubees30-10 +--- +# GL Textured Cube This sample demonstrates a rotating cube rendered with textures via OpenTK's GL APIs. diff --git a/UpdateUsersProfile/README.md b/UpdateUsersProfile/README.md index 5e95bfadc..253911b8e 100644 --- a/UpdateUsersProfile/README.md +++ b/UpdateUsersProfile/README.md @@ -1,5 +1,16 @@ -Update the User's Profile -========================= +--- +name: Xamarin.Android - Update the User's Profile +description: This sample app accompanies the recipe, Update the User's Profile. This sample creates a display name for the owner of the device (John Doe) and... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: updateusersprofile +--- +# Update the User's Profile This sample app accompanies the recipe, [Update the User's Profile](http://developer.xamarin.com/recipes/android/data/contentproviders/update_the_users_profile/). @@ -10,7 +21,8 @@ read back to confirm that the name was set, then launches the **Contacts** app to view the user's profile. A single screen provides a button that initiates the update and view sequence: -Author ------- +![Update the User's Profile application screenshot](Screenshots/screenshot-1.png "Update the User's Profile application screenshot") + +## Author Mark McLemore diff --git a/UserInterface/ActionBarTabs/README.md b/UserInterface/ActionBarTabs/README.md index c6f9d3fdb..864717439 100644 --- a/UserInterface/ActionBarTabs/README.md +++ b/UserInterface/ActionBarTabs/README.md @@ -1,5 +1,16 @@ -Tabbed Layouts ActionBar Sample -=============================== +--- +name: Xamarin.Android - Tabbed Layouts ActionBar Sample +description: This sample app accompanies the article, Tabbed Layouts with the ActionBar. +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: userinterface-actionbartabs +--- +# Tabbed Layouts ActionBar Sample This sample app accompanies the article, [Tabbed Layouts with the ActionBar](https://developer.xamarin.com/guides/android/user_interface/tab_layout/actionbar/). diff --git a/UserInterface/EditTextSample/README.md b/UserInterface/EditTextSample/README.md index 53412bfb1..dd695ed80 100755 --- a/UserInterface/EditTextSample/README.md +++ b/UserInterface/EditTextSample/README.md @@ -1,5 +1,16 @@ -Edit Text Sample -================ +--- +name: Xamarin.Android - Edit Text Sample +description: This sample app accompanies the user interface article, Edit Text. +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: userinterface-edittextsample +--- +# Edit Text Sample This sample app accompanies the user interface article, [Edit Text](https://docs.microsoft.com/xamarin/android/user-interface/controls/edit-text). diff --git a/UserInterface/FlashCardPager/README.md b/UserInterface/FlashCardPager/README.md index 44f4bb085..d35fef64f 100644 --- a/UserInterface/FlashCardPager/README.md +++ b/UserInterface/FlashCardPager/README.md @@ -1,5 +1,16 @@ -FlashCardPager -============== +--- +name: Xamarin.Android - FlashCardPager +description: FlashCardPager is a sample app that accompanies the article, ViewPager. This sample demonstrates how to use ViewPager and PagerTabStrip together to... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: userinterface-flashcardpager +--- +# FlashCardPager **FlashCardPager** is a sample app that accompanies the article, [ViewPager](http://developer.xamarin.com/guides/android/user_interface/viewpager/). @@ -19,8 +30,9 @@ depends on [Android Support Library v4](https://components.xamarin.com/gettingstarted/xamandroidsupportv4-18). -Author ------- +![FlashCardPager application screenshot](Screenshots/screen-1.png "FlashCardPager application screenshot") + +## Author Copyright 2016 Xamarin diff --git a/UserInterface/TabHostWalkthrough/README.md b/UserInterface/TabHostWalkthrough/README.md index 222c63645..2cf715789 100644 --- a/UserInterface/TabHostWalkthrough/README.md +++ b/UserInterface/TabHostWalkthrough/README.md @@ -1,5 +1,16 @@ -TabHost Walkthrough Start -========================= +--- +name: Xamarin.Android - TabHost Walkthrough Start +description: This sample app provides the starting point for the article, Walkthrough - Creating a tabbed UI with TabHost. +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: userinterface-tabhostwalkthrough +--- +# TabHost Walkthrough Start This sample app provides the starting point for the article, [Walkthrough - Creating a tabbed UI with TabHost](https://developer.xamarin.com/guides/android/user_interface/tab_layout/Walkthrough_Creating_a_tabbed_ui/). diff --git a/UserInterface/TimePickerDemo/README.md b/UserInterface/TimePickerDemo/README.md index 540e459fe..f21435fb2 100644 --- a/UserInterface/TimePickerDemo/README.md +++ b/UserInterface/TimePickerDemo/README.md @@ -1,5 +1,16 @@ -TimePickerDemo -============== +--- +name: Xamarin.Android - TimePickerDemo +description: TimePickerDemo is a sample app that accompanies the article, Time Picker. This sample demonstrates how to use the TimePickerDialog, wrapped in a... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: userinterface-timepickerdemo +--- +# TimePickerDemo **TimePickerDemo** is a sample app that accompanies the article, [Time Picker](https://developer.xamarin.com/guides/android/user_interface/controls/pickers/time-picker/). @@ -10,8 +21,9 @@ a modal dialog when the user clicks a button on an Activity. When the time is set by the user, the dialog exits and a handler updates a `TextView` on the Activity screen with the time that was selected. -Author ------- +![TimePickerDemo application screenshot](Screenshots/01-initial-screen.png "TimePickerDemo application screenshot") + +## Author Copyright 2017 Xamarin diff --git a/UserInterface/TreePager/README.md b/UserInterface/TreePager/README.md index 2a4496769..ddb8a0943 100755 --- a/UserInterface/TreePager/README.md +++ b/UserInterface/TreePager/README.md @@ -1,5 +1,16 @@ -TreePager -========= +--- +name: Xamarin.Android - TreePager +description: TreePager is a sample app that accompanies the article, ViewPager. This sample demonstrates how to use ViewPager and PagerTabStrip together to... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: userinterface-treepager +--- +# TreePager **TreePager** is a sample app that accompanies the article, [ViewPager](http://developer.xamarin.com/guides/android/user_interface/viewpager/). @@ -20,8 +31,9 @@ that this app depends on [Android Support Library v4](https://components.xamarin.com/gettingstarted/xamandroidsupportv4-18). -Author ------- +![TreePager application screenshot](Screenshots/1-larch.png "TreePager application screenshot") + +## Author Copyright 2016 Xamarin diff --git a/ViewPagerIndicator/README.md b/ViewPagerIndicator/README.md index 40ad911a7..f97946045 100644 --- a/ViewPagerIndicator/README.md +++ b/ViewPagerIndicator/README.md @@ -1,10 +1,20 @@ -ViewPagerIndicator -================== +--- +name: Xamarin.Android - ViewPagerIndicator +description: This is a port of the wonderful [ViewPagerIndicator library by JakeWharton][1] License Copyright 2011 Patrik Åkerfeldt Copyright 2011 Francisco... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: viewpagerindicator +--- +# ViewPagerIndicator This is a port of the wonderful [ViewPagerIndicator library by JakeWharton][1] -License -======= +# License Copyright 2011 Patrik Åkerfeldt Copyright 2011 Francisco Figueiredo Jr. diff --git a/WalkingGameCompleteAndroid/README.md b/WalkingGameCompleteAndroid/README.md index 1692ce51a..7613e7fbc 100644 --- a/WalkingGameCompleteAndroid/README.md +++ b/WalkingGameCompleteAndroid/README.md @@ -1,5 +1,16 @@ -MonoGame WalkingGame Project for Android -==================================== +--- +name: Xamarin.Android - MonoGame WalkingGame Project for Android +description: This is a small demo game using MonoGame for Android. It is the result of working through the the entire Introduction to Monogame walkthrough. This... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: walkinggamecompleteandroid +--- +# MonoGame WalkingGame Project for Android This is a small demo game using MonoGame for Android. It is the result of working through the the entire Introduction to Monogame walkthrough. @@ -7,7 +18,6 @@ This single solution contains two projects: one for Android and one cross-platf The demo can be played by touching the screen to move the character around the screen. -Author ------- +## Author Victor Chelaru \ No newline at end of file diff --git a/WalkingGameEmptyAndroid/README.md b/WalkingGameEmptyAndroid/README.md index 34f7d3a23..02f1600cf 100644 --- a/WalkingGameEmptyAndroid/README.md +++ b/WalkingGameEmptyAndroid/README.md @@ -1,5 +1,16 @@ -MonoGame Empty Project for Android -==================================== +--- +name: Xamarin.Android - MonoGame Empty Project for Android +description: This project serves as a starting-point for MonoGame Android projects. It is the result of working through the Part 2 - Creating a MonoGame Android... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: walkinggameemptyandroid +--- +# MonoGame Empty Project for Android This project serves as a starting-point for MonoGame Android projects. It is the result of working through the Part 2 - Creating a MonoGame Android Project walkthrough. It is titled WalkingGame as that is the name of the project created by the full Introduction to MonoGame walkthrough. @@ -7,7 +18,8 @@ This single solution contains two projects: one for Android and one cross-platf When executed this project displays only a blue screen. -Author ------- +![MonoGame Empty Project for Android application screenshot](Screenshots/Screenshot1.png "MonoGame Empty Project for Android application screenshot") + +## Author Victor Chelaru \ No newline at end of file diff --git a/WeatherREST/README.md b/WeatherREST/README.md index 17abd4bf2..98a45fe17 100644 --- a/WeatherREST/README.md +++ b/WeatherREST/README.md @@ -1,5 +1,16 @@ -WeatherREST -=========== +--- +name: Xamarin.Android - WeatherREST +description: This sample app accompanies the article, Call a REST Web Service. You can use this sample to learn how to call a RESTful service via HTTP and... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: weatherrest +--- +# WeatherREST This sample app accompanies the article, [Call a REST Web Service](http://developer.xamarin.com/recipes/android/web_services/consuming_services/call_a_rest_web_service/). @@ -26,7 +37,8 @@ see if it contains a "daily limit has been exceeded" message. You will need an Android device or emulator with a large screen (such as a Nexus 5 or an AVD with the WXGA720 skin) to view the results. -Author ------- +![WeatherREST application screenshot](Screenshots/before.png "WeatherREST application screenshot") + +## Author Mark McLemore diff --git a/WebViewJavaScriptInterface/README.md b/WebViewJavaScriptInterface/README.md index 00bf64e20..f2a7cebed 100644 --- a/WebViewJavaScriptInterface/README.md +++ b/WebViewJavaScriptInterface/README.md @@ -1,5 +1,16 @@ -WebView JavaScript Interface -============================ +--- +name: Xamarin.Android - WebView JavaScript Interface +description: This demonstrates C - to - JavaScript interoperability in WebView (through Java interface). For the API details, see:... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: webviewjavascriptinterface +--- +# WebView JavaScript Interface This demonstrates C# - to - JavaScript interoperability in WebView (through Java interface). @@ -11,8 +22,7 @@ This sample requires Mono for Android 4.1 or later, since it makes use of Java.Interop.ExportAttribute. -Testing Note -============ +# Testing Note _DO NOT RUN_ this sample on an API 10 (Android v2.3.3) emulator; it _will_ break diff --git a/android-m/AutoBackup/README.md b/android-m/AutoBackup/README.md index 128c14a47..e271e2482 100644 --- a/android-m/AutoBackup/README.md +++ b/android-m/AutoBackup/README.md @@ -1,19 +1,29 @@ -AutoBackup Sample -================= +--- +name: Xamarin.Android - AutoBackup Sample +description: This sample demonstrates how to selectively disable Automatic Backups in Android M. Instructions Tap the Add File button to create a file with... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: android-m-autobackup +--- +# AutoBackup Sample This sample demonstrates how to selectively disable Automatic Backups in Android M. -Instructions ------------- +## Instructions * Tap the Add File button to create a file with selected specifications. -Build Requirements ------------------- +## Build Requirements Using this sample requires the Android M Developer Preview and the Xamarin.Android M Web Preview -Authors -------- +![AutoBackup Sample application screenshot](Screenshots/add-file.png "AutoBackup Sample application screenshot") + +## Authors Copyright (c) 2014 The Android Open Source Project, Inc. Ported from [Android Automatic Backup Sample](https://github.com/googlesamples/android-AutoBackupForApps) Ported to Xamarin.Android by Peter Collins \ No newline at end of file diff --git a/android-m/ConfirmCredential/README.md b/android-m/ConfirmCredential/README.md index b46ea1f66..4644b3747 100644 --- a/android-m/ConfirmCredential/README.md +++ b/android-m/ConfirmCredential/README.md @@ -1,20 +1,30 @@ -Confirm Credential Sample -========================= +--- +name: Xamarin.Android - Confirm Credential Sample +description: This sample demonstrates how to use device credentials (PIN, Pattern, Password) in your app. Instructions Set up a secure lock screen in ‘Settings... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: android-m-confirmcredential +--- +# Confirm Credential Sample This sample demonstrates how to use device credentials (PIN, Pattern, Password) in your app. -Instructions ------------- +## Instructions * Set up a secure lock screen in ‘Settings -> Security -> Screenlock’. * Tap the Purchase button and confirm the secure lock screen credentials. -Build Requirements ------------------- +## Build Requirements Using this sample requires the Android M Developer Preview and the Xamarin.Android M Web Preview -Authors -------- +![Confirm Credential Sample application screenshot](Screenshots/confirm-pattern.png "Confirm Credential Sample application screenshot") + +## Authors Copyright (c) 2014 The Android Open Source Project, Inc. Ported from [Android Confirm Credential Sample](https://github.com/googlesamples/android-ConfirmCredential) Ported to Xamarin.Android by Peter Collins \ No newline at end of file diff --git a/android-m/FingerprintDialog/README.md b/android-m/FingerprintDialog/README.md index 535ed4931..bdbaf939f 100644 --- a/android-m/FingerprintDialog/README.md +++ b/android-m/FingerprintDialog/README.md @@ -1,21 +1,31 @@ -Fingerprint Dialog Sample -========================= +--- +name: Xamarin.Android - Fingerprint Dialog Sample +description: This sample demonstrates how to use registered fingerprints to authenticate the user in an app. Instructions Touch the Purchase button to open a... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: android-m-fingerprintdialog +--- +# Fingerprint Dialog Sample This sample demonstrates how to use registered fingerprints to authenticate the user in an app. -Instructions ------------- +## Instructions * Touch the Purchase button to open a fingerprint authentication dialog. * Either scan in your registered fingerprint to authenticate or enter your password. * Requires a device with a built in fingerprint reader. * This app does not store either your fingerprint nor your password. -Build Requirements ------------------- +## Build Requirements Building this sample requires a device that is Android M or later, the Xamarin.Android M Web Preview, and the Android M Developer Preview. -Authors -------- +![Fingerprint Dialog Sample application screenshot](Screenshots/enable-fingerprint-lock.png "Fingerprint Dialog Sample application screenshot") + +## Authors Copyright (c) 2014 The Android Open Source Project, Inc. Ported from [Android Fingerprint Dialog Sample](https://github.com/googlesamples/android-FingerprintDialog) Ported to Xamarin.Android by Aaron Sky \ No newline at end of file diff --git a/android-m/RuntimePermissions/README.md b/android-m/RuntimePermissions/README.md index bcb9ce81a..d29bf41c2 100644 --- a/android-m/RuntimePermissions/README.md +++ b/android-m/RuntimePermissions/README.md @@ -1,21 +1,31 @@ -Runtime Permissions Sample -========================== +--- +name: Xamarin.Android - Runtime Permissions Sample +description: This sample shows runtime permissions available in Android M and above. It shows how to check and request permissions at runtime, handle backwards... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: android-m-runtimepermissions +--- +# Runtime Permissions Sample This sample shows runtime permissions available in Android M and above. It shows how to check and request permissions at runtime, handle backwards compatibility using the support library and how to declare optional permissions for M-devices only. -Instructions ------------- +## Instructions * Tap on the Camera or Contacts buttons to display a permissions request dialog. * Grant permission to view Camera or Contacts fragments. -Build Requirements ------------------- +## Build Requirements Using this sample requires the Android M Developer Preview and the Xamarin.Android M Web Preview -Authors -------- +![Runtime Permissions Sample application screenshot](Screenshots/camera-fragment.png "Runtime Permissions Sample application screenshot") + +## Authors Copyright (c) 2014 The Android Open Source Project, Inc. Ported from [Android RuntimePermissions Sample](https://github.com/googlesamples/android-RuntimePermissions) Ported to Xamarin.Android by Peter Collins \ No newline at end of file diff --git a/android-n/ActiveNotifications/README.md b/android-n/ActiveNotifications/README.md index 5a8a91078..da2578d84 100644 --- a/android-n/ActiveNotifications/README.md +++ b/android-n/ActiveNotifications/README.md @@ -1,25 +1,34 @@ -Active Notifications Sample -=========================== +--- +name: Xamarin.Android - Active Notifications Sample +description: This sample demonstrates how to use the NotficationManager API to tell you how many notifications your application is currently showing.... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: android-n-activenotifications +--- +# Active Notifications Sample This sample demonstrates how to use the NotficationManager API to tell you how many notifications your application is currently showing. -Instructions ------------- +## Instructions * Touch the 'Add a Notification' button to display a notification. * Scroll the notification bar down to clear notifications. -Build Requirements ------------------- +## Build Requirements Using this sample requires the Android M Developer Preview and the Xamarin.Android M Web Preview -Notes ------ +## Notes This sample will crash when attempting to simultaniously clear larger sets of notifications. See https://github.com/googlesamples/android-ActiveNotifications/issues/1 for more info. -Authors -------- +![Active Notifications Sample application screenshot](Screenshots/active-notifications.png "Active Notifications Sample application screenshot") + +## Authors Copyright (c) 2014 The Android Open Source Project, Inc. Ported from [Android ActiveNotification Sample](https://github.com/googlesamples/android-ActiveNotifications) Ported to Xamarin.Android by Peter Collins \ No newline at end of file diff --git a/android-n/AppShortcuts/README.md b/android-n/AppShortcuts/README.md index 0a9d227a5..31f21a215 100644 --- a/android-n/AppShortcuts/README.md +++ b/android-n/AppShortcuts/README.md @@ -1,21 +1,31 @@ -AppShortcuts Sample -=================== +--- +name: Xamarin.Android - AppShortcuts Sample +description: This sample demonstrates how to use the Launcher Shortcuts API introduced in Android 7.1 (API 25). This API allows an application to define a set... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: android-n-appshortcuts +--- +# AppShortcuts Sample This sample demonstrates how to use the Launcher Shortcuts API introduced in Android 7.1 (API 25). This API allows an application to define a set of Intents which are displayed as when a user long-presses on the app's launcher icon. Examples are given for registering both links both statically in XML, as well as dynamically at runtime. -Instructions ------------- +## Instructions You can use the shortcuts feature in Android 7.1 (API 25) to bring users from the launcher directly to key actions within your app. Users simply long-press your app's launcher icon to reveal the app's shortcuts, then tap on a shortcut to jump to the associated action. These shortcuts are a great way to engage users, and they let you surface the functionality of your app even before users launch your app. -Build Requirements ------------------- +## Build Requirements Using this sample requires the Android 7.1 (API 25) and the Xamarin.Android 7.1.99 or higher. -Authors -------- +![AppShortcuts Sample application screenshot](Screenshots/Screenshot_1480604454.png "AppShortcuts Sample application screenshot") + +## Authors Copyright (c) 2016 The Android Open Source Project, Inc. Ported from [Android AppShortcuts Sample](https://github.com/googlesamples/android-AppShortcuts). Ported to Xamarin.Android by Gonzalo Martin. \ No newline at end of file diff --git a/android-n/CommitContentSample/README.md b/android-n/CommitContentSample/README.md index b24ade814..9da5ce03e 100644 --- a/android-n/CommitContentSample/README.md +++ b/android-n/CommitContentSample/README.md @@ -1,10 +1,20 @@ -CommitContentSample -=================== +--- +name: Xamarin.Android - CommitContentSample +description: This sample demonstrates how to write an keyboard which sends rich content (such as images) to text fields using the Commit Content API.... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: android-n-commitcontentsample +--- +# CommitContentSample This sample demonstrates how to write an keyboard which sends rich content (such as images) to text fields using the Commit Content API. -Instructions ------------- +## Instructions You **must** run first the *SampleIME* project (following the instructions to enable the virtual keyboard) and then you can run the *SampleApp* project. @@ -18,13 +28,13 @@ This sample does not have a default Activity. After installing it, you will need Users often want to communicate with emojis, stickers, and other kinds of rich content. In previous versions of Android, soft keyboards (input method editors or IMEs) could send only unicode emoji to apps. For rich content (such as images), apps had to either build app-specific APIs that couldn't be used in other apps or use workarounds like sending images through the Easy Share Action or the clipboard. -Build Requirements ------------------- +## Build Requirements Using this sample requires the Android 7.1 (API 25) and the Xamarin.Android 7.1.99 or higher. -Authors -------- +![CommitContentSample application screenshot](Screenshots/Screenshot_1480948732.png "CommitContentSample application screenshot") + +## Authors Copyright (c) 2016 The Android Open Source Project, Inc. SampleIME ported from [CommitContentSampleIME](https://github.com/googlesamples/android-CommitContentSampleIME). SampleApp ported from [CommitContentSampleApp](https://github.com/googlesamples/android-CommitContentSampleApp). diff --git a/android-n/DirectBoot/README.md b/android-n/DirectBoot/README.md index 1ada0b572..cc38dee22 100644 --- a/android-n/DirectBoot/README.md +++ b/android-n/DirectBoot/README.md @@ -1,5 +1,16 @@ -Direct Boot Sample -=========================== +--- +name: Xamarin.Android - Direct Boot Sample +description: This sample demonstrates how to store data in a device-protected storage which is always available while the device is booted both before and after... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: android-n-directboot +--- +# Direct Boot Sample This sample demonstrates how to store data in a device-protected storage which is always available while the device is booted both before and after any user credentials(PIN/Pattern/Password) are entered. @@ -7,20 +18,19 @@ while the device is booted both before and after any user credentials(PIN/Patter Sensitive data (such as user's emails, auth tokens) shouldn't be stored in a device-protected storage because the storage isn't protected by the user's credential (PIN/Pattern/Password). -Instructions ------------- +## Instructions * Tap the alarm button in the bottom right to add an alarm. * When an alarm is triggered, a notification will be displayed. View the notification to end the alarm noise. -Build Requirements ------------------- +## Build Requirements Using this sample requires the Android N Developer Preview and the Xamarin.Android N Web Preview. -Authors -------- +![Direct Boot Sample application screenshot](Screenshots/alarm_notification.png "Direct Boot Sample application screenshot") + +## Authors Copyright (c) 2016 The Android Open Source Project, Inc. Ported from [Android DirectBoot Sample](https://github.com/googlesamples/android-DirectBoot) diff --git a/android-n/MessagingService/README.md b/android-n/MessagingService/README.md index dd5504809..56896af51 100644 --- a/android-n/MessagingService/README.md +++ b/android-n/MessagingService/README.md @@ -1,5 +1,16 @@ -Messaging Service Sample -========================== +--- +name: Xamarin.Android - Messaging Service Sample +description: This sample shows a simple service that sends notifications using NotificationCompat. It also extends the notification with Remote Input to allow... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: android-n-messagingservice +--- +# Messaging Service Sample This sample shows a simple service that sends notifications using NotificationCompat. It also extends the notification with Remote @@ -10,8 +21,7 @@ when the notification is presented there. Note: Each unread conversation from a user is sent as a distinct notification. -Introduction ------------- +## Introduction #### Flow MessagingFragment is shown to the user. Depending on the button clicked, the MessagingService is @@ -23,25 +33,23 @@ with the appropriate conversationId. Similarly, when a reply is received, the Me is called with the appropriate ConversationId. MessageLogger logs each event and shows them in a TextView in MessagingFragment for correlation. -Instructions ------------- +## Instructions * Launch the application * Tap any button to send conversations * Read the message and observe the application registering the event * Clear the log and tap any button to send additional conversations -Build Requirements ------------------- +## Build Requirements Using this sample requires the Android SDK platform for Android 5.0 (API level 23). -Screenshots -------------- +## Screenshots Screenshot Screenshot Screenshot Screenshot -Authors -------- +![Messaging Service Sample application screenshot](Screenshots/1-one-convo-one-message.png "Messaging Service Sample application screenshot") + +## Authors Copyright (c) 2016 The Android Open Source Project, Inc. Ported from [Android MessagingService Sample](https://github.com/googlesamples/android-messagingService) diff --git a/android-n/MultiWindowPlayground/README.md b/android-n/MultiWindowPlayground/README.md index 34b722822..6523a73a6 100644 --- a/android-n/MultiWindowPlayground/README.md +++ b/android-n/MultiWindowPlayground/README.md @@ -1,22 +1,32 @@ -MultiWindow Playground Sample -=========================== +--- +name: Xamarin.Android - MultiWindow Playground Sample +description: This sample demonstrates how to use the MultiWindow API introduced in Android N allowing adjacent and floating app windows. Instructions Launch... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: android-n-multiwindowplayground +--- +# MultiWindow Playground Sample This sample demonstrates how to use the MultiWindow API introduced in Android N allowing adjacent and floating app windows. -Instructions ------------- +## Instructions * Launch activities with different MultiWindow configurations by clicking the buttons. * Observe lifecycle events logged on screen. -Build Requirements ------------------- +## Build Requirements Using this sample requires the Android N Developer Preview and the Xamarin.Android N Web Preview. -Authors -------- +![MultiWindow Playground Sample application screenshot](Screenshots/adjacent_activity.png "MultiWindow Playground Sample application screenshot") + +## Authors Copyright (c) 2016 The Android Open Source Project, Inc. Ported from [Android MultiWindowPlayground Sample](https://github.com/googlesamples/android-MultiWindowPlayground). Ported to Xamarin.Android by Kyle White. \ No newline at end of file diff --git a/android-n/ScopedDirectoryAccess/README.md b/android-n/ScopedDirectoryAccess/README.md index ffe0932f6..15e5a599c 100644 --- a/android-n/ScopedDirectoryAccess/README.md +++ b/android-n/ScopedDirectoryAccess/README.md @@ -1,23 +1,33 @@ -Scoped Directory Access Sample -=========================== +--- +name: Xamarin.Android - Scoped Directory Access Sample +description: This sample demonstrates how to use the Scoped Directory Access API introduced Android N to easily access specific directories. This serves as an... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: android-n-scopeddirectoryaccess +--- +# Scoped Directory Access Sample This sample demonstrates how to use the Scoped Directory Access API introduced Android N to easily access specific directories. This serves as an alternative to having to define READ_EXTERNAL_STORAGE or WRITE_EXTERNAL_STORAGE permissions in your manifest. -Instructions ------------- +## Instructions * Select a directory location you'd like to access from the dropdown menu. * Tap 'Open' to request permission and then display the contents of the directory. -Build Requirements ------------------- +## Build Requirements Using this sample requires the Android N Developer Preview and the Xamarin.Android N Web Preview, as well as at least Android Build Tools v24.0.0 rc1. -Authors -------- +![Scoped Directory Access Sample application screenshot](Screenshots/directory_content.png "Scoped Directory Access Sample application screenshot") + +## Authors Copyright (c) 2014 The Android Open Source Project, Inc. Ported from [Android ScopedDirectoryAccess Sample](https://github.com/googlesamples/android-ScopedDirectoryAccess) Ported to Xamarin.Android by Peter Collins \ No newline at end of file diff --git a/android-o/AndroidCipher/README.md b/android-o/AndroidCipher/README.md index e12d2539a..11b78933a 100644 --- a/android-o/AndroidCipher/README.md +++ b/android-o/AndroidCipher/README.md @@ -1,11 +1,21 @@ -AndroidCipher -===== +--- +name: Xamarin.Android - AndroidCipher +description: AndroidCipher is a simple project which encrypts and decrypts string with usage of android cipher. This sample demonstrates some of the new... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: android-o-androidcipher +--- +# AndroidCipher AndroidCipher is a simple project which encrypts and decrypts string with usage of android cipher. This sample demonstrates some of the new encryption algorithms available in Android 8.1 Namely, Cipher.getParameters().getParameterSpec(IvParameterSpec.class) no longer works for algorithms that use GCM. Instead, use getParameterSpec(GCMParameterSpec.class). -Authors -------- +## Authors Malkin Dmytro \ No newline at end of file diff --git a/android-o/AndroidPlayLocation/LocUpdFgService/README.md b/android-o/AndroidPlayLocation/LocUpdFgService/README.md index 794416926..d1b56fd9d 100644 --- a/android-o/AndroidPlayLocation/LocUpdFgService/README.md +++ b/android-o/AndroidPlayLocation/LocUpdFgService/README.md @@ -1,22 +1,32 @@ -LocationUpdatesForegroundService Sample -======================================= +--- +name: Xamarin.Android - LocationUpdatesForegroundService Sample +description: This sample demonstrates how to use the Location API to get updates about a device's location using a bound and started foreground service.... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: android-o-androidplaylocation-locupdfgservice +--- +# LocationUpdatesForegroundService Sample This sample demonstrates how to use the Location API to get updates about a device's location using a bound and started foreground service. -Instructions ------------- +## Instructions Press the “Request Location Updates” button to start the location updates service and listen any location changes. Press the “Remove Location Updates” if you do not want to listen any location updates. -Build Requirements ------------------- +## Build Requirements Using this sample requires the Android 8.0 (API 26) and Xamarin.Android 7.5.x or higher. -Authors -------- +![LocationUpdatesForegroundService Sample application screenshot](Screenshots/Main.png "LocationUpdatesForegroundService Sample application screenshot") + +## Authors Copyright (c) 2017 The Android Open Source Project, Inc. Ported from [Android LocationUpdatesForegroundService Sample](https://github.com/googlesamples/android-play-location/tree/master/LocationUpdatesForegroundService). Ported to Xamarin.Android by Gonzalo Martin. diff --git a/android-o/AndroidPlayLocation/LocUpdPendIntent/README.md b/android-o/AndroidPlayLocation/LocUpdPendIntent/README.md index 1205b88fa..c2d7635dc 100644 --- a/android-o/AndroidPlayLocation/LocUpdPendIntent/README.md +++ b/android-o/AndroidPlayLocation/LocUpdPendIntent/README.md @@ -1,24 +1,34 @@ -LocationUpdatesPendingIntent Sample -=================================== +--- +name: Xamarin.Android - LocationUpdatesPendingIntent Sample +description: This sample demonstrates how to use the Location API to get updates about a device's location using a PendingIntent. Instructions Sample shows... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: android-o-androidplaylocation-locupdpendintent +--- +# LocationUpdatesPendingIntent Sample This sample demonstrates how to use the Location API to get updates about a device's location using a PendingIntent. -Instructions ------------- +## Instructions Sample shows implementation using an IntentService as well as a BroadcastReceiver. Press the “Request Updates” button to start the location updates service and listen any location changes. Press the “Remove Updates” if you do not want to listen any location updates. -Build Requirements ------------------- +## Build Requirements Using this sample requires the Android 8.0 (API 26) and the Xamarin.Android 7.5.x or higher. -Authors -------- +![LocationUpdatesPendingIntent Sample application screenshot](Screenshots/Main.png "LocationUpdatesPendingIntent Sample application screenshot") + +## Authors Copyright (c) 2017 The Android Open Source Project, Inc. Ported from [Android LocationUpdatesPendingIntent Sample](https://github.com/googlesamples/android-play-location/tree/master/LocationUpdatesPendingIntent). Ported to Xamarin.Android by Gonzalo Martin. \ No newline at end of file diff --git a/android-o/AutofillFramework/README.md b/android-o/AutofillFramework/README.md index 92346dca8..6e46c2fdf 100644 --- a/android-o/AutofillFramework/README.md +++ b/android-o/AutofillFramework/README.md @@ -1,21 +1,31 @@ -AutofillFramework Sample -======================== +--- +name: Xamarin.Android - AutofillFramework Sample +description: This sample demonstrates the use of the Autofill Framework. It includes implementations of client Activities with views that should be autofilled,... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: android-o-autofillframework +--- +# AutofillFramework Sample This sample demonstrates the use of the Autofill Framework. It includes implementations of client Activities with views that should be autofilled, and a Service that can provide autofill data to client Activities. -Instructions ------------- +## Instructions To set the device's default Autofill service to the one in the sample, edit Settings > System > Languages & Input > Advanced > Auto-fill service and select the sample app. To edit the service's settings, tap the settings icon next to the Auto-fill service list item or open the Autofill Settings launcher icon.. Here, you can set whether you want to enable authentication on the entire autofill Response or just on individual autofill datasets. You should also set the master password to “unlock” authenticated autofill data with. -Build Requirements ------------------- +## Build Requirements Using this sample requires the Android 8.0 (API 26) and the Xamarin.Android 8.0 or higher. -Authors -------- +![AutofillFramework Sample application screenshot](Screenshots/ask_for_save.png "AutofillFramework Sample application screenshot") + +## Authors Copyright (c) 2017 The Android Open Source Project, Inc. Ported from [Android AutofillFramework Sample](https://github.com/googlesamples/android-AutofillFramework/). Ported to Xamarin.Android by Malkin Dmytro. \ No newline at end of file diff --git a/android-o/DownloadableFonts/README.md b/android-o/DownloadableFonts/README.md index 19e1cb1bb..858a9eace 100644 --- a/android-o/DownloadableFonts/README.md +++ b/android-o/DownloadableFonts/README.md @@ -1,22 +1,32 @@ -DownloadableFonts Sample -======================== +--- +name: Xamarin.Android - DownloadableFonts Sample +description: This sample demonstrates how to use the Downloadable Fonts feature introduced in Android O. Downloadable Fonts is a feature that allows apps to... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: android-o-downloadablefonts +--- +# DownloadableFonts Sample This sample demonstrates how to use the Downloadable Fonts feature introduced in Android O. Downloadable Fonts is a feature that allows apps to request a certain font from a provider instead of bundling it or downloading it themselves. This means, there is no need to bundle the font as an asset. -Instructions ------------- +## Instructions There are two ways of requesting a font to download: - Request a font to download from C# code - Declare a downloaded font in an XML file -Build Requirements ------------------- +## Build Requirements Using this sample requires the Android 8.0 (API 26) and the Xamarin.Android 7.5.x or higher. -Authors -------- +![DownloadableFonts Sample application screenshot](Screenshots/Crete Round font.png "DownloadableFonts Sample application screenshot") + +## Authors Copyright (c) 2017 The Android Open Source Project, Inc. Ported from [Android DownloadableFonts Sample](https://github.com/googlesamples/android-DownloadableFonts). Ported to Xamarin.Android by Gonzalo Martin. \ No newline at end of file diff --git a/android-o/EmojiCompat/README.md b/android-o/EmojiCompat/README.md index 090d49131..d0d009243 100644 --- a/android-o/EmojiCompat/README.md +++ b/android-o/EmojiCompat/README.md @@ -1,5 +1,16 @@ -EmojiCompat Sample -================== +--- +name: Xamarin.Android - EmojiCompat Sample +description: This sample demonstrates usage of EmojiCompat support library. You can use this library to prevent your app from showing missing emoji characters... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: android-o-emojicompat +--- +# EmojiCompat Sample This sample demonstrates usage of EmojiCompat support library. You can use this library to prevent your app from showing missing emoji characters in the form of tofu (□). You @@ -17,14 +28,14 @@ users do not need to wait for Android OS updates to get the latest emoji. You need to first initialize EmojiCompat to load the metadata and the typeface. You can use either bundled or downloadable fonts. -Build Requirements --------------- +## Build Requirements Using this sample requires the Android 8.0 (API 26) and the Xamarin.Android 7.5 or higher. -Authors -------- +![EmojiCompat Sample application screenshot](Screenshots/Main.png "EmojiCompat Sample application screenshot") + +## Authors Copyright (c) 2017 The Android Open Source Project, Inc. diff --git a/android-o/NotificationChannels/README.md b/android-o/NotificationChannels/README.md index 80bf6cbbe..c58e107ec 100644 --- a/android-o/NotificationChannels/README.md +++ b/android-o/NotificationChannels/README.md @@ -1,28 +1,37 @@ -NotificationChannels Sample -======================================= +--- +name: Xamarin.Android - NotificationChannels Sample +description: This sample demonstrates how to use the new Notification Channels system introduced in Android Oreo. This system allows for increased customization... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: android-o-notificationchannels +--- +# NotificationChannels Sample This sample demonstrates how to use the new Notification Channels system introduced in Android Oreo. This system allows for increased customization and control over how notifications are displayed. -Instructions ------------- +## Instructions Tap any of the Send buttons to create a notification. Both channels can be altered by tapping their respective settings buttons to demonstrate various notification options. -Build Requirements ------------------- +## Build Requirements Using this sample requires the Android 8.0 (API 26) and Xamarin.Android 7.5.x or higher. -Authors -------- +![NotificationChannels Sample application screenshot](Screenshots/main_activity.png "NotificationChannels Sample application screenshot") + +## Authors Ported from [Android NotificationChannels Sample](https://github.com/googlesamples/android-NotificationChannels). Ported to Xamarin.Android by Peter Collins. -License -------- +## License Copyright (c) 2017 The Android Open Source Project, Inc. Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at diff --git a/android-o/PictureInPicture/README.md b/android-o/PictureInPicture/README.md index d4ebcbfe8..42ec86444 100644 --- a/android-o/PictureInPicture/README.md +++ b/android-o/PictureInPicture/README.md @@ -1,28 +1,37 @@ -PictureInPicture Sample -======================= +--- +name: Xamarin.Android - PictureInPicture Sample +description: This sample demonstrates basic usage of the new Picture-in-Picture (PiP) mode for handheld devices introduced in Oreo. The sample plays a video... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: android-o-pictureinpicture +--- +# PictureInPicture Sample This sample demonstrates basic usage of the new Picture-in-Picture (PiP) mode for handheld devices introduced in Oreo. The sample plays a video which continues uninterrupted while switching back and forth between display modes or other activities. -Instructions ------------- +## Instructions Tap the button to drop in to Picture-in-Picture mode. Tapping on the PiP view will present controls which can be used to pause, show info, return to full screen, or exit the application. -Build Requirements ------------------- +## Build Requirements Using this sample requires the Android 8.0 (API 26) and Xamarin.Android 7.5.x or higher. -Authors -------- +![PictureInPicture Sample application screenshot](Screenshots/main_activity.png "PictureInPicture Sample application screenshot") + +## Authors Ported from [Android PictureInPicture Sample](https://github.com/googlesamples/android-PictureInPicture/). Ported to Xamarin.Android by Peter Collins. -License -------- +## License Copyright (c) 2017 The Android Open Source Project, Inc. Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at diff --git a/android-o/SafeBrowsing/README.md b/android-o/SafeBrowsing/README.md index bc5a07270..e14061cd6 100644 --- a/android-o/SafeBrowsing/README.md +++ b/android-o/SafeBrowsing/README.md @@ -1,4 +1,16 @@ -SafeBrowsing +--- +name: Xamarin.Android - SafeBrowsing +description: SafeBrowsing is a simple project which demonstrates the safe browsing functionality of an Android Web View. This is a new feature added in Android... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: android-o-safebrowsing +--- +# SafeBrowsing SafeBrowsing is a simple project which demonstrates the safe browsing functionality of an Android Web View. This is a new feature added in Android 8.1 (API 27). @@ -10,6 +22,6 @@ The recommended way to enable this feature is to add the following tag to your A The StartSafeBrowsing method initializes safe browsing if the meta-data tag mentioned above is set. Safe browsing is not fully supported on all devices. -Authors +## Authors Malkin Dmytro \ No newline at end of file diff --git a/android-p/AndroidPMiniDemo/README.md b/android-p/AndroidPMiniDemo/README.md index cdf35f9c4..4152cd2b9 100644 --- a/android-p/AndroidPMiniDemo/README.md +++ b/android-p/AndroidPMiniDemo/README.md @@ -1,5 +1,16 @@ -Android P Mini Demo -=================== +--- +name: Xamarin.Android - Android P Mini Demo +description: AndroidPMiniDemo is a sample app that accompanies the article, Android P Preview. This sample demonstrates the new display cutout and image... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: android-p-androidpminidemo +--- +# Android P Mini Demo **AndroidPMiniDemo** is a sample app that accompanies the article, [Android P Preview](https://docs.microsoft.com/en-us/xamarin/android/platform/android-p). @@ -63,8 +74,9 @@ that contains an image. installed via the Android SDK Manager. -Author ------- +![Android P Mini Demo application screenshot](Screenshots/1-image-notification.png "Android P Mini Demo application screenshot") + +## Author Copyright 2018 Microsoft diff --git a/android-support/ViewModel/README.md b/android-support/ViewModel/README.md index a893b3cf9..d1b3d33fe 100644 --- a/android-support/ViewModel/README.md +++ b/android-support/ViewModel/README.md @@ -1,17 +1,28 @@ -ViewModel Sample -================ +--- +name: Xamarin.Android - ViewModel Sample +description: This sample demonstrates usage of ViewModel and LifeCycle Architecture Components library by Android. Build Requirements Using this sample requires... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: android-support-viewmodel +--- +# ViewModel Sample This sample demonstrates usage of ViewModel and LifeCycle [Architecture Components](https://developer.android.com/topic/libraries/architecture/index.html) library by Android. -Build Requirements --------------- +## Build Requirements Using this sample requires the Android 8.1 (API 27) and the Xamarin.Android 8.2 or higher. -Authors -------- +![ViewModel Sample application screenshot](Screenshots/Home.png "ViewModel Sample application screenshot") + +## Authors Copyright (c) 2018 The Android Open Source Project, Inc. diff --git a/android5.0/ActivitySceneTransitionBasic/README.md b/android5.0/ActivitySceneTransitionBasic/README.md index 7dd1849fa..b49b6391e 100644 --- a/android5.0/ActivitySceneTransitionBasic/README.md +++ b/android5.0/ActivitySceneTransitionBasic/README.md @@ -1,17 +1,27 @@ -ActivitySceneTransitionBasic -===== +--- +name: Xamarin.Android - ActivitySceneTransitionBasic +description: This sample demonstrates how to the use Activity scene transitions when transitioning from one activity to another. Uses a combination of moveImage... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: android50-activityscenetransitionbasic +--- +# ActivitySceneTransitionBasic This sample demonstrates how to the use Activity scene transitions when transitioning from one activity to another. Uses a combination of moveImage and changeBounds to nicely transition from a grid of images to an activity with a large image and detail text. -Instructions ------------- +## Instructions * Touch each photo to activate a transition to a details page for each one. * Hitting the back button will activate a transition back to the grid of photos. -Build Requirements ------------------- +## Build Requirements This sample requires Xamarin.Android 4.17 or later and an Android L or later device. -Author ------- +![ActivitySceneTransitionBasic application screenshot](Screenshots/Detailed View.png "ActivitySceneTransitionBasic application screenshot") + +## Author Copyright (c) 2005-2008, The Android Open Source Project Ported to Xamarin.Android by Sean Pearl diff --git a/android5.0/AppRestrictionSchema/README.md b/android5.0/AppRestrictionSchema/README.md index a358a19d9..ed1599486 100644 --- a/android5.0/AppRestrictionSchema/README.md +++ b/android5.0/AppRestrictionSchema/README.md @@ -1,22 +1,32 @@ -App Restriction Schema -============== +--- +name: Xamarin.Android - App Restriction Schema +description: This sample shows a basic demonstration of using a profile owner to set app restrictions in Android. This is to used alongside... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: android50-apprestrictionschema +--- +# App Restriction Schema This sample shows a basic demonstration of using a profile owner to set app restrictions in Android. This is to used alongside AppRestrictionEnforcer, which serves as a profile owner for this. -Instructions ------------- +## Instructions * Run the project * Pressing the button on this fragment pops up a simple Toast message. The button is enabled or disabled according to the restrictions set by device/profile owner. You can use the AppRestrictionEnforcer sample as a profile owner for this. -Build Requirements ------------------- +## Build Requirements * Xamarin Studio 5.3+ * Xamarin Android 4.20+ * Android SDK (Lollipop) -Author ------- +![App Restriction Schema application screenshot](Screenshots/Not Restricted.png "App Restriction Schema application screenshot") + +## Author Copyright 2014 The Android Open Source Project Ported to Xamarin.Android by John Pilczak diff --git a/android5.0/AppUsageStatistics/README.md b/android5.0/AppUsageStatistics/README.md index 2f259de65..42d2c07b6 100644 --- a/android5.0/AppUsageStatistics/README.md +++ b/android5.0/AppUsageStatistics/README.md @@ -1,11 +1,21 @@ -App Usage Statistics Sample -========================== +--- +name: Xamarin.Android - App Usage Statistics Sample +description: This sample shows how to use the App usage statistics API to let users collect statistics related to usage of the applications. Introduction The... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: android50-appusagestatistics +--- +# App Usage Statistics Sample This sample shows how to use the App usage statistics API to let users collect statistics related to usage of the applications. -Introduction ------------- +## Introduction The App usage statistics API allows app developers to collect statistics related to usage of the applications. This API provides more detailed usage information than the deprecated @@ -14,24 +24,22 @@ getRecentTasks() method. This example illustrates how to use the App usage statistics API by showing the applications sorted by the timestamp of the last time each app was used. -Instructions ------------- +## Instructions * If it exists, tap on the "Open Apps with usage access settings" button and grant permission to access app usage statistics * Tap on the drop down list and select an interval * View basic usage statistics for apps on the device -Build Requirements ------------------- +## Build Requirements Using this sample requires the Android SDK platform for Android 5.0 (API level 21). -Screenshots -------------- +## Screenshots Screenshot Screenshot -Authors -------- +![App Usage Statistics Sample application screenshot](Screenshots/1-view-daily.png "App Usage Statistics Sample application screenshot") + +## Authors Copyright (c) 2014 The Android Open Source Project, Inc. Ported from [Android AppUsageStatistics Sample](https://github.com/googlesamples/android-AppUsageStatistics) diff --git a/android5.0/Camera2Basic/Readme.md b/android5.0/Camera2Basic/Readme.md index 1ef10abff..7ab293f07 100644 --- a/android5.0/Camera2Basic/Readme.md +++ b/android5.0/Camera2Basic/Readme.md @@ -1,22 +1,32 @@ -Camera2 Basic Sample -==================== +--- +name: Xamarin.Android - Camera2 Basic Sample +description: This sample demonstrates how to use the new Camera2 APIs to render a preview of a camera's viewport, capture an image and save it to the device's... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: android50-camera2basic +--- +# Camera2 Basic Sample This sample demonstrates how to use the new Camera2 APIs to render a preview of a camera's viewport, capture an image and save it to the device's storage. -Instructions ------------- +## Instructions * Touch the Picture button to take a photo that will automatically be saved on your device. * Touch the info button to find out a little bit more about the app. * Requires a device with a rear facing camera -Build Requirements ------------- +## Build Requirements Using this sample requires a device that is Android L or later and Xamarin.Android 4.17 or later. -Author ------- +![Camera2 Basic Sample application screenshot](Screenshots/Viewfinder.png "Camera2 Basic Sample application screenshot") + +## Author Copyright (c) 2005-2008, The Android Open Source Project Ported to Xamarin.Android by Christopher Blackman diff --git a/android5.0/Camera2Raw/README.md b/android5.0/Camera2Raw/README.md index 7e5570961..fd30fa1d7 100644 --- a/android5.0/Camera2Raw/README.md +++ b/android5.0/Camera2Raw/README.md @@ -1,20 +1,30 @@ -Camera2Raw Sample -================= +--- +name: Xamarin.Android - Camera2Raw Sample +description: This sample demonstrates how to use the Camera2 APIs to capture RAW camera buffers and save them to the devices storage as a dng file. Instructions... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: android50-camera2raw +--- +# Camera2Raw Sample This sample demonstrates how to use the Camera2 APIs to capture RAW camera buffers and save them to the devices storage as a dng file. -Instructions ------------- +## Instructions * Touch the Picture button to take two photos that will automatically be saved on your device. * Touch the Info button to find out a little bit more about the app. * Requires a device with a rear facing camera -Build Requirements ------------------- +## Build Requirements Using this sample requires a device that is Android 5.0 or later and Xamarin.Android 5.0 or later. -Authors -------- +![Camera2Raw Sample application screenshot](Screenshots/Camera2Raw0.png "Camera2Raw Sample application screenshot") + +## Authors Copyright (c) 2014 The Android Open Source Project, Inc. Ported from [Android Camera2Raw Sample](https://github.com/googlesamples/android-Camera2Raw) Ported to Xamarin.Android by Aaron Sky \ No newline at end of file diff --git a/android5.0/Camera2VideoSample/README.md b/android5.0/Camera2VideoSample/README.md index 4da13971e..9851780af 100644 --- a/android5.0/Camera2VideoSample/README.md +++ b/android5.0/Camera2VideoSample/README.md @@ -1,24 +1,33 @@ -Camera2Video -================== +--- +name: Xamarin.Android - Camera2Video +description: This sample demonstrates how record video on Android L through the use of the Android.Hardware.Camera2 namespace. Instructions Touch the Record... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: android50-camera2videosample +--- +# Camera2Video This sample demonstrates how record video on Android L through the use of the Android.Hardware.Camera2 namespace. -Instructions ------------- +## Instructions * Touch the Record button to begin recording video. * Touch the Stop button to stop recording video and save the video. * Touch the Info button to display some more information on the app. * Requires a device with a rear facing camera -Build Requirements ------------------- +## Build Requirements Using this sample requires a device that is Android L or later and Xamarin.Android 4.17 or later. -Notes ------ +## Notes This sample is known to crash on various device and Lollipop version combinations. See https://github.com/googlesamples/android-Camera2Video/issues/2 for more info. -Author ------- +![Camera2Video application screenshot](Screenshots/info.png "Camera2Video application screenshot") + +## Author Copyright (c) 2005-2008, The Android Open Source Project Ported to Xamarin.Android by John Pilczak diff --git a/android5.0/CardViewSample/README.md b/android5.0/CardViewSample/README.md index 85ee556cf..3725c4fff 100644 --- a/android5.0/CardViewSample/README.md +++ b/android5.0/CardViewSample/README.md @@ -1,22 +1,32 @@ -CardView -======== +--- +name: Xamarin.Android - CardView +description: Demonstration of the CardView API introduced in Android L. Instructions Run the project Adjust the sliders to adjust the elevation and corner... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: android50-cardviewsample +--- +# CardView Demonstration of the CardView API introduced in Android L. -Instructions ------------- +## Instructions * Run the project * Adjust the sliders to adjust the elevation and corner radius of the CardView -Build Requirements ------------------- +## Build Requirements * Xamarin Studio 5.3+ * Xamarin Android 4.17+ * Android SDK (L Preview) -Author ------- +![CardView application screenshot](Screenshots/Adjusted.png "CardView application screenshot") + +## Author Copyright 2014 The Android Open Source Project Ported to Xamarin.Android by John Pilczak diff --git a/android5.0/Cheesesquare/README.md b/android5.0/Cheesesquare/README.md index 7e1528f54..bff04cfb1 100644 --- a/android5.0/Cheesesquare/README.md +++ b/android5.0/Cheesesquare/README.md @@ -1,9 +1,20 @@ +--- +name: Xamarin.Android - Cheesesquare Sample +description: 'Demos the new Android Design library. This is not an exhaustive sample, but shows some of the important features in the Design library: -...' +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: android50-cheesesquare +--- **NOTE:** This is a port of the original Cheesesquare Sample by Chris Banes, available on GitHub: https://github.com/chrisbanes/cheesesquare ![Screenshot](https://raw.githubusercontent.com/xamarin/monodroid-samples/master/android5.0/Cheesesquare/screenshot.png) -Cheesesquare Sample -=================================== +# Cheesesquare Sample Demos the new Android Design library. This is not an exhaustive sample, but shows some of the important features in the Design library: @@ -14,15 +25,13 @@ some of the important features in the Design library: - NavigationView - Snackbar -Pre-requisites --------------- +## Pre-requisites - Android SDK v22 - Android Build Tools v22.0.1 - Android Support Repository v22.2 -License -------- +## License Copyright 2014 The Android Open Source Project, Inc. diff --git a/android5.0/ClippingBasic/README.md b/android5.0/ClippingBasic/README.md index 055e76714..e5b9749b3 100644 --- a/android5.0/ClippingBasic/README.md +++ b/android5.0/ClippingBasic/README.md @@ -1,19 +1,29 @@ -ClippingBasic -================== +--- +name: Xamarin.Android - ClippingBasic +description: This sample demonstrates simple clipping in Android L. Instructions Touch the Show Log/Hide Log button to toggle the log. Touch the text to cycle... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: android50-clippingbasic +--- +# ClippingBasic This sample demonstrates simple clipping in Android L. -Instructions ------------- +## Instructions * Touch the Show Log/Hide Log button to toggle the log. * Touch the text to cycle through three different strings. * Touch the Clip/Remove Clipping button to toggle the clipping of the text. -Build Requirements ------------------- +## Build Requirements Using this sample requires a device that is Android L or later and Xamarin.Android 4.17 or later. -Author ------- +![ClippingBasic application screenshot](Screenshots/Clipped.png "ClippingBasic application screenshot") + +## Author Copyright (c) 2005-2008, The Android Open Source Project Ported to Xamarin.Android by John Pilczak diff --git a/android5.0/DirectorySelection/README.md b/android5.0/DirectorySelection/README.md index 899592c93..3037d0fa7 100644 --- a/android5.0/DirectorySelection/README.md +++ b/android5.0/DirectorySelection/README.md @@ -1,16 +1,25 @@ -Directory Selection Sample -========================== +--- +name: Xamarin.Android - Directory Selection Sample +description: This sample shows how to use the Directory Selection API to let users select an entire directory subtree, which extends the Storage Access... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: android50-directoryselection +--- +# Directory Selection Sample This sample shows how to use the Directory Selection API to let users select an entire directory subtree, which extends the Storage Access Framework introduced in Android 4.4 (API level 19). -Introduction ------------- +## Introduction The Directory Selection API, which was introduced in Android 5.0 (API level 21) extends the Storage Access Framework to let users select an entire directory subtree, giving apps read/write access to all contained documents without requiring user confirmation for each item. -Instructions ------------- +## Instructions * Tap on the "Open Directory" button * Select any directory @@ -18,17 +27,16 @@ Instructions * Tap on the "Create Directory" button, create a directory with any name * Observe the newly created directory being listed in addition to the already existing contents -Build Requirements ------------------- +## Build Requirements Using this sample requires the Android SDK platform for Android 5.0 (API level 21). -Screenshots -------------- +## Screenshots Screenshot Screenshot Screenshot Screenshot Screenshot -Authors -------- +![Directory Selection Sample application screenshot](Screenshots/1-landing-page.png "Directory Selection Sample application screenshot") + +## Authors Copyright (c) 2014 The Android Open Source Project, Inc. Ported from [Android DirectorySelection Sample](https://github.com/googlesamples/android-DirectorySelection) diff --git a/android5.0/DocumentCentricApps/README.md b/android5.0/DocumentCentricApps/README.md index 3db7e0eb8..a6a589759 100644 --- a/android5.0/DocumentCentricApps/README.md +++ b/android5.0/DocumentCentricApps/README.md @@ -1,23 +1,33 @@ -DocumentCentricApps -============== +--- +name: Xamarin.Android - DocumentCentricApps +description: This sample demonstrates the basic usage of the new Document-Centric Apps API. Instructions Run the project Tap the Create New Document button to... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: android50-documentcentricapps +--- +# DocumentCentricApps This sample demonstrates the basic usage of the new Document-Centric Apps API. -Instructions ------------- +## Instructions * Run the project * Tap the Create New Document button to show a new document activity. * Enable the Task per document checkbox to make it so that each document is a new document in the task manager. -Build Requirements ------------------- +## Build Requirements * Xamarin Studio 5.3+ * Xamarin Android 4.20+ * Android SDK v21 -Author ------- +![DocumentCentricApps application screenshot](Screenshots/MainActivity.png "DocumentCentricApps application screenshot") + +## Author Copyright 2014 The Android Open Source Project Ported to Xamarin.Android by John Pilczak diff --git a/android5.0/DocumentCentricRelinquishIdentity/README.md b/android5.0/DocumentCentricRelinquishIdentity/README.md index cc64e0b4d..942cad75e 100644 --- a/android5.0/DocumentCentricRelinquishIdentity/README.md +++ b/android5.0/DocumentCentricRelinquishIdentity/README.md @@ -1,23 +1,33 @@ -DocumentCentricRelinquishIdentity -============== +--- +name: Xamarin.Android - DocumentCentricRelinquishIdentity +description: This sample demonstrates how to change the label of a document activity in recents using the Document-Centric API. Instructions Run the project Tap... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: android50-documentcentricrelinquishidentity +--- +# DocumentCentricRelinquishIdentity This sample demonstrates how to change the label of a document activity in recents using the Document-Centric API. -Instructions ------------- +## Instructions * Run the project * Tap the Create New Document button to show a new document activity. * Enable the Task per document checkbox to make it so that each document is a new document in the task manager. -Build Requirements ------------------- +## Build Requirements * Xamarin Studio 5.3+ * Xamarin Android 4.20+ * Android SDK v21 -Author ------- +![DocumentCentricRelinquishIdentity application screenshot](Screenshots/New Label.png "DocumentCentricRelinquishIdentity application screenshot") + +## Author Copyright 2014 The Android Open Source Project Ported to Xamarin.Android by John Pilczak diff --git a/android5.0/DrawableTinting/README.md b/android5.0/DrawableTinting/README.md index 309eb6e72..1cd4fb155 100644 --- a/android5.0/DrawableTinting/README.md +++ b/android5.0/DrawableTinting/README.md @@ -1,5 +1,16 @@ -Drawable Tinting -============== +--- +name: Xamarin.Android - Drawable Tinting +description: Sample that shows applying tinting and color filters to Drawables both programmatically and as Drawable resources in XML Tinting is set on a... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: android50-drawabletinting +--- +# Drawable Tinting Sample that shows applying tinting and color filters to Drawables both programmatically and as Drawable resources in XML @@ -7,21 +18,20 @@ Tinting is set on a nine-patch drawable through the "tint" and "tintMode" parame Programmatically, tinting is applied to a Drawable through its "setColorFilter" method, with a reference to a color and a PorterDuff blend mode. The color and blend mode can be changed from the UI to see the effect of different options. -Instructions ------------- +## Instructions * Run the project * Adjust the sliders and tint mode and see how it affects the images on the screen * To see the log output, tap the Show Log button -Build Requirements ------------------- +## Build Requirements * Xamarin Studio 5.3+ * Xamarin Android 4.17+ * Android SDK (L Preview) -Author ------- +![Drawable Tinting application screenshot](Screenshots/Screenshot_2014-10-07-16-08-12.png "Drawable Tinting application screenshot") + +## Author Copyright 2014 The Android Open Source Project Ported to Xamarin.Android by John Pilczak diff --git a/android5.0/ElevationBasic/README.md b/android5.0/ElevationBasic/README.md index 32b7e8b72..f8834acb5 100644 --- a/android5.0/ElevationBasic/README.md +++ b/android5.0/ElevationBasic/README.md @@ -1,23 +1,33 @@ -Elevation Basic -============== +--- +name: Xamarin.Android - Elevation Basic +description: This sample demonstrates two alternative ways to move a view in the z-axis. The first view has a fixed elevation using XML and the second one is... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: android50-elevationbasic +--- +# Elevation Basic This sample demonstrates two alternative ways to move a view in the z-axis. The first view has a fixed elevation using XML and the second one is raised when the user taps on it, using TranslationZ = (int). This layering is part of Android's new [Material Design](https://developer.android.com/preview/material/index.html) -Instructions ------------- +## Instructions * Run the project * Click on the purple square to raise the view. -Build Requirements ------------------- +## Build Requirements * Xamarin Studio 5.3+ * Xamarin Android 4.17+ -Author ------- +![Elevation Basic application screenshot](Screenshots/down.png "Elevation Basic application screenshot") + +## Author Copyright (c) 2013, The Android Open Source Project Ported to Xamarin.Android by Ben O'Halloran diff --git a/android5.0/ElevationDrag/README.md b/android5.0/ElevationDrag/README.md index 0d15e8479..4ab3cfb89 100644 --- a/android5.0/ElevationDrag/README.md +++ b/android5.0/ElevationDrag/README.md @@ -1,23 +1,33 @@ -Elevation Drag -============== +--- +name: Xamarin.Android - Elevation Drag +description: This sample demonstrates a drag and drop action on different shapes. Elevation and z-translation are used to render the shadows. The views are... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: android50-elevationdrag +--- +# Elevation Drag This sample demonstrates a drag and drop action on different shapes. Elevation and z-translation are used to render the shadows. The views are clipped using different outlines. Elevation and z-translation are part of Android's new [Material Design](https://developer.android.com/preview/material/index.html). -Instructions ------------- +## Instructions * Run the project * Click on the purple square to raise the view. -Build Requirements ------------------- +## Build Requirements * Xamarin Studio 5.3+ * Xamarin Android 4.17+ -Author ------- +![Elevation Drag application screenshot](Screenshots/circle.png "Elevation Drag application screenshot") + +## Author Copyright (c) 2013, The Android Open Source Project Ported to Xamarin.Android by Ben O'Halloran diff --git a/android5.0/FloatingActionButtonBasic/README.md b/android5.0/FloatingActionButtonBasic/README.md index ae833936e..d8bed76c2 100644 --- a/android5.0/FloatingActionButtonBasic/README.md +++ b/android5.0/FloatingActionButtonBasic/README.md @@ -1,22 +1,32 @@ -Floating Action Button Basic -============== +--- +name: Xamarin.Android - Floating Action Button Basic +description: This sample shows the two sizes of Floating Action Buttons and how to interact with them. Instructions Run the project Click on each floating... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: android50-floatingactionbuttonbasic +--- +# Floating Action Button Basic This sample shows the two sizes of Floating Action Buttons and how to interact with them. -Instructions ------------- +## Instructions * Run the project * Click on each floating action button to check or uncheck the button. -Build Requirements ------------------- +## Build Requirements * Xamarin Studio 5.3+ * Xamarin Android 4.17+ * Android SDK (L Preview) -Author ------- +![Floating Action Button Basic application screenshot](Screenshots/Checked.png "Floating Action Button Basic application screenshot") + +## Author Copyright 2014 The Android Open Source Project Ported to Xamarin.Android by John Pilczak diff --git a/android5.0/GoogleIO2014Master/README.md b/android5.0/GoogleIO2014Master/README.md index a456e246b..ad3221f5c 100644 --- a/android5.0/GoogleIO2014Master/README.md +++ b/android5.0/GoogleIO2014Master/README.md @@ -1,5 +1,16 @@ -Google I/O 2014 -========================== +--- +name: Xamarin.Android - Google I/O 2014 +description: 'This sample demonstrates the new Material Design APIs introduced in Android Lollipop, including: Custom theme colors Dynamic palette Circular...' +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: android50-googleio2014master +--- +# Google I/O 2014 This sample demonstrates the new Material Design APIs introduced in Android Lollipop, including: @@ -8,25 +19,23 @@ This sample demonstrates the new Material Design APIs introduced in Android Loll * Circular reveal * Activity transitions -Notes ------ +## Notes In order to properly display maps, edit the following meta-data in AndroidManifest.xml to include your own Mapsv2 Api Key: * Screenshot -Authors -------- +![Permission Request Sample application screenshot](Screenshots/1-permission-request.png "Permission Request Sample application screenshot") + +## Authors Copyright (c) 2014 The Android Open Source Project, Inc. Ported from [Android PermissionRequest Sample](https://github.com/googlesamples/android-permissionRequest) diff --git a/android5.0/RecyclerViewSample/README.md b/android5.0/RecyclerViewSample/README.md index ce4321cda..5b189e76a 100644 --- a/android5.0/RecyclerViewSample/README.md +++ b/android5.0/RecyclerViewSample/README.md @@ -1,23 +1,33 @@ -RecyclerView -============== +--- +name: Xamarin.Android - RecyclerView +description: Demonstration of using RecyclerView with a LinearLayoutManager to create a vertical ListView. Instructions Run the project Tap the Show Log button... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: android50-recyclerviewsample +--- +# RecyclerView Demonstration of using RecyclerView with a LinearLayoutManager to create a vertical ListView. -Instructions ------------- +## Instructions * Run the project * Tap the Show Log button to show the log * Scroll through the elements and watch the log to see the RecyclerView in action. -Build Requirements ------------------- +## Build Requirements * Xamarin Studio 5.3+ * Xamarin Android 4.17+ * Android SDK (L Preview) -Author ------- +![RecyclerView application screenshot](Screenshots/Screenshot.png "RecyclerView application screenshot") + +## Author Copyright 2014 The Android Open Source Project Ported to Xamarin.Android by John Pilczak diff --git a/android5.0/RecyclerViewer/README.md b/android5.0/RecyclerViewer/README.md index cb4e71ea1..846ad718c 100755 --- a/android5.0/RecyclerViewer/README.md +++ b/android5.0/RecyclerViewer/README.md @@ -1,5 +1,16 @@ -RecyclerViewer -============== +--- +name: Xamarin.Android - RecyclerViewer +description: This sample app accompanies the articles CardView and RecyclerView. You can use this sample to learn how to use the new CardView and RecyclerView... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: android50-recyclerviewer +--- +# RecyclerViewer This sample app accompanies the articles [CardView](http://developer.xamarin.com/guides/android/user_interface/cardview) and @@ -25,7 +36,8 @@ the `RecyclerView` with a simple "Photo Album" database, a manager* positions the `CardView` row items within the `RecyclerView`. -Author ------- +![RecyclerViewer application screenshot](Screenshots/screen-1.png "RecyclerViewer application screenshot") + +## Author Mark McLemore diff --git a/android5.0/RevealEffectBasic/README.md b/android5.0/RevealEffectBasic/README.md index c626e00a2..cca07238c 100644 --- a/android5.0/RevealEffectBasic/README.md +++ b/android5.0/RevealEffectBasic/README.md @@ -1,22 +1,32 @@ -Reveal Effect Basic -============== +--- +name: Xamarin.Android - Reveal Effect Basic +description: Basic sample to demonstrate the reveal effect. Instructions Run the project Click on the Reveal button to demonstrate the reveal effect on the... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: android50-revealeffectbasic +--- +# Reveal Effect Basic Basic sample to demonstrate the reveal effect. -Instructions ------------- +## Instructions * Run the project * Click on the "Reveal" button to demonstrate the reveal effect on the purple square. -Build Requirements ------------------- +## Build Requirements * Xamarin Studio 5.3+ * Xamarin Android 4.17+ * Android SDK (L Preview) -Author ------- +![Reveal Effect Basic application screenshot](Screenshots/Screenshot.png "Reveal Effect Basic application screenshot") + +## Author Copyright 2014 The Android Open Source Project Ported to Xamarin.Android by John Pilczak diff --git a/android5.0/ScreenCapture/README.md b/android5.0/ScreenCapture/README.md index 0033a6f91..747a663f7 100644 --- a/android5.0/ScreenCapture/README.md +++ b/android5.0/ScreenCapture/README.md @@ -1,24 +1,34 @@ -ScreenCapture -===== +--- +name: Xamarin.Android - ScreenCapture +description: This sample demonstrates how to use Media Projection API to capture device screen in real time and show it on a SurfaceView. Instructions Launch... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: android50-screencapture +--- +# ScreenCapture This sample demonstrates how to use Media Projection API to capture device screen in real time and show it on a SurfaceView. -Instructions ------------- +## Instructions * Launch the app on a Lollipop device or emulator. * On devices with display widths under 720dp, tap the Show Log button to show the sample's log. * Tap the start button to start capturing the screen and displaying it in the ScreenCaptureFragment's SurfaceView. -Build Requirements ------------------- +## Build Requirements * Xamarin.Android 4.20 * Android SDK v21 * Android Support Repository * Android Build Tools v21.1.1 -Author ------- +![ScreenCapture application screenshot](Screenshots/Screen Capture.png "ScreenCapture application screenshot") + +## Author Copyright 2014 The Android Open Source Project, Inc. diff --git a/android5.0/ThemeSwitcher/README.md b/android5.0/ThemeSwitcher/README.md index fe4c3bde3..08579376e 100755 --- a/android5.0/ThemeSwitcher/README.md +++ b/android5.0/ThemeSwitcher/README.md @@ -1,5 +1,16 @@ -Android 5.0 Theme Switcher -========================== +--- +name: Xamarin.Android - Android 5.0 Theme Switcher +description: This examples shows how to use different Android 5.0 Lollipop Material Theme styles in different activities, how to create a customized Material... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: android50-themeswitcher +--- +# Android 5.0 Theme Switcher This examples shows how to use different Android 5.0 Lollipop Material Theme styles in different activities, how to create a customized @@ -7,14 +18,14 @@ Material Theme style, and how to theme an individual view. A companion article is available at [Material Theme](http://developer.xamarin.com/guides/android/user_interface/material_theme). -Requirements ------------- +## Requirements To build and run this sample, you must first enable Android 5.0 support as described in [Setting Up an Android 5.0 Project](http://developer.xamarin.com/guides/android/platform_features/introduction_to_lollipop#settingup). -Authors -------- +![Android 5.0 Theme Switcher application screenshot](Screenshots/material-custom-theme.png "Android 5.0 Theme Switcher application screenshot") + +## Authors Mark McLemore diff --git a/android5.0/Toolbar/README.md b/android5.0/Toolbar/README.md index 313ccab3d..886778e87 100644 --- a/android5.0/Toolbar/README.md +++ b/android5.0/Toolbar/README.md @@ -1,22 +1,32 @@ -Toolbar -============== +--- +name: Xamarin.Android - Toolbar +description: Basic sample of replacing the ActionBar with the new ToolBar. Instructions Run the project Click on the Toolbar items to see click handlers Build... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: android50-toolbar +--- +# Toolbar Basic sample of replacing the ActionBar with the new ToolBar. -Instructions ------------- +## Instructions * Run the project * Click on the Toolbar items to see click handlers -Build Requirements ------------------- +## Build Requirements * Xamarin Studio 5.5+ * Xamarin Android 4.20+ * Android SDK with Android 5.0 -Author ------- +![Toolbar application screenshot](Screenshots/MultipleToolbars.png "Toolbar application screenshot") + +## Author Copyright 2014 Xamarin Created by James Montemagno diff --git a/android5.0/Topeka/README.md b/android5.0/Topeka/README.md index 4c8fcefc4..94d6e231b 100644 --- a/android5.0/Topeka/README.md +++ b/android5.0/Topeka/README.md @@ -1,5 +1,16 @@ -Topeka for Android -================== +--- +name: Xamarin.Android - Topeka for Android +description: A quiz game that showcases material design on Android. This sample makes use of JSON.NET, SQLite.NET and heavy principles of Material Design. You... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: android50-topeka +--- +# Topeka for Android A quiz game that showcases material design on Android. This sample makes use of JSON.NET, SQLite.NET and heavy principles of [Material Design](https://www.google.com/design/spec/material-design/introduction.html). You can read all about the original sample on the [Android Developers blog](http://android-developers.blogspot.co.uk/2015/06/more-material-design-with-topeka-for_16.html). @@ -9,7 +20,9 @@ A quiz game that showcases material design on Android. This sample makes use of -### Authors +#![Topeka for Android application screenshot](Screenshots/Screenshot1.png "Topeka for Android application screenshot") + +## Authors Copyright (c) 2015 Google, Inc. Ported from [Topeka for Android](https://github.com/googlesamples/android-topeka) diff --git a/google-services/AdMobExample/README.md b/google-services/AdMobExample/README.md index aa027cdd8..3fae53fdb 100644 --- a/google-services/AdMobExample/README.md +++ b/google-services/AdMobExample/README.md @@ -1,21 +1,31 @@ -AdMobExample Sample -================= +--- +name: Xamarin.Android - AdMobExample Sample +description: This sample demonstrates how to display different types of ads using Google AdMob with Google Play Services. Instructions Tap the Show Interstitial... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: google-services-admobexample +--- +# AdMobExample Sample This sample demonstrates how to display different types of ads using Google AdMob with Google Play Services. -Instructions ------------- +## Instructions * Tap the Show Interstitial Ad button to display an ad in between activity transition. -Build Requirements ------------------- +## Build Requirements Using this sample requires the Android SDK platform for Android 5.0 (API level 21). -Authors -------- +![AdMobExample Sample application screenshot](Screenshots/fullscreen_ad.png "AdMobExample Sample application screenshot") + +## Authors Copyright (c) 2015 Google, Inc. Ported from [Google AdMob Quickstart Sample](https://github.com/googlesamples/google-services/tree/master/android/admob) diff --git a/google-services/Analytics/README.md b/google-services/Analytics/README.md index e40aeae3e..9d24cb4c0 100644 --- a/google-services/Analytics/README.md +++ b/google-services/Analytics/README.md @@ -1,23 +1,33 @@ -Analytics Sample -================= +--- +name: Xamarin.Android - Analytics Sample +description: This sample demonstrates how to report screen views to Google Analytics. Instructions Add your Google Analytics Tracking ID in place of... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: google-services-analytics +--- +# Analytics Sample This sample demonstrates how to report screen views to Google Analytics. -Instructions ------------- +## Instructions * Add your Google Analytics Tracking ID in place of "UA-XXXXXXX-X" in AnalyticsApplication.cs * Build and run. * Swipe between images to register screen views. -Build Requirements ------------------- +## Build Requirements Using this sample requires the Android SDK platform for Android 5.0 (API level 21). -Authors -------- +![Analytics Sample application screenshot](Screenshots/view_b.png "Analytics Sample application screenshot") + +## Authors Copyright (c) 2015 Google, Inc. Ported from [Google Analytics Quickstart](https://github.com/googlesamples/google-services/tree/master/android/analytics) diff --git a/google-services/AppIndexing/README.md b/google-services/AppIndexing/README.md index d42774dde..ce5972f71 100644 --- a/google-services/AppIndexing/README.md +++ b/google-services/AppIndexing/README.md @@ -1,15 +1,24 @@ -App Indexing Sample -================= +--- +name: Xamarin.Android - App Indexing Sample +description: This sample demonstrates how to make your app viewable in Google Search using Google App Indexing. Instructions On the device's web browser,... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: google-services-appindexing +--- +# App Indexing Sample This sample demonstrates how to make your app viewable in Google Search using Google App Indexing. -Instructions ------------- +## Instructions * On the device's web browser, navigate to the deep link URL defined in MainActivity.cs. -Authors -------- +## Authors Copyright (c) 2015 Google, Inc. Ported from [Google App Indexing Quickstart Sample](https://github.com/googlesamples/google-services/tree/master/android/app-indexing) Ported to Xamarin.Android by Aaron Sky \ No newline at end of file diff --git a/google-services/AppInvite/README.md b/google-services/AppInvite/README.md index df2f67ec3..b29e464bb 100644 --- a/google-services/AppInvite/README.md +++ b/google-services/AppInvite/README.md @@ -1,10 +1,20 @@ -App Invite Sample -================= +--- +name: Xamarin.Android - App Invite Sample +description: This sample demonstrates how to allow your users to invite people they know to use your app using Google App Invites. Instructions Tap the Invite... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: google-services-appinvite +--- +# App Invite Sample This sample demonstrates how to allow your users to invite people they know to use your app using Google App Invites. -Instructions ------------- +## Instructions * Tap the Invite Friends button and Log in to a valid Google developer account. * Follow these steps to [enable Google services for your app.](https://developers.google.com/mobile/add?platform=android&cntapi=appinvite&cnturl=https:%2F%2Fdevelopers.google.com%2Fapp-invites%2Fandroid%2Fguides%2Fapp%3Fconfigured%3Dtrue%23add-config&cntlbl=Continue%20Adding%20App%20Invites) @@ -13,13 +23,13 @@ Instructions * Once the service is configured, you'll be able to send an invite to an email address or phone number. -Build Requirements ------------------- +## Build Requirements Using this sample requires the Android SDK platform for Android 5.0 (API level 21). -Authors -------- +![App Invite Sample application screenshot](Screenshots/app-invites-sample.png "App Invite Sample application screenshot") + +## Authors Copyright (c) 2015 Google, Inc. Ported from [Google App Invites Quickstart Sample](https://github.com/googlesamples/google-services/tree/master/android/appinvites) diff --git a/google-services/Fitness/BasicHistoryApi/README.md b/google-services/Fitness/BasicHistoryApi/README.md index 4a9871235..ab2033d68 100644 --- a/google-services/Fitness/BasicHistoryApi/README.md +++ b/google-services/Fitness/BasicHistoryApi/README.md @@ -1,21 +1,31 @@ -Android Fit History Api Sample -============================== +--- +name: Xamarin.Android - Android Fit History Api Sample +description: This sample demonstrates how to use the Android Fit History API. Instructions Make sure to enable 'Google Sign-In' for your application via the... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: google-services-fitness-basichistoryapi +--- +# Android Fit History Api Sample This sample demonstrates how to use the Android Fit History API. -Instructions ------------- +## Instructions * Make sure to enable 'Google Sign-In' for your application via the [Developer Console](https://developers.google.com/mobile/add?platform=android). * Log into a Google account to display mock step count data. -Build Requirements ------------------- +## Build Requirements Using this sample requires the Android SDK platform for Android 5.0 (API level 21). -Authors -------- +![Android Fit History Api Sample application screenshot](Screenshots/screenshot1.png "Android Fit History Api Sample application screenshot") + +## Authors Copyright (c) 2015 Google, Inc. Ported from [Android Fit History Api Sample](https://github.com/googlesamples/android-fit/tree/master/BasicHistoryApi) diff --git a/google-services/Fitness/BasicHistorySessions/README.md b/google-services/Fitness/BasicHistorySessions/README.md index 11b327836..9c128e753 100644 --- a/google-services/Fitness/BasicHistorySessions/README.md +++ b/google-services/Fitness/BasicHistorySessions/README.md @@ -1,22 +1,32 @@ -Android Fit History Api Sessions Sample -======================================= +--- +name: Xamarin.Android - Android Fit History Api Sessions Sample +description: This sample demonstrates how to use the Android Fit History API. Instructions Make sure to enable 'Google Sign-In' for your application via the... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: google-services-fitness-basichistorysessions +--- +# Android Fit History Api Sessions Sample This sample demonstrates how to use the Android Fit History API. -Instructions ------------- +## Instructions * Make sure to enable 'Google Sign-In' for your application via the [Developer Console](https://developers.google.com/mobile/add?platform=android). * Log into a Google account to display mock session data. -Build Requirements ------------------- +## Build Requirements Using this sample requires the Android SDK platform for Android 5.0 (API level 21). -Authors -------- +![Android Fit History Api Sessions Sample application screenshot](Screenshots/screenshot1.png "Android Fit History Api Sessions Sample application screenshot") + +## Authors Copyright (c) 2015 Google, Inc. Ported from [Android Fit History Api Sessions Sample](https://github.com/googlesamples/android-fit/tree/master/BasicHistorySessions) diff --git a/google-services/Fitness/BasicRecordingApi/README.md b/google-services/Fitness/BasicRecordingApi/README.md index 12596a101..4e6c7f4cf 100644 --- a/google-services/Fitness/BasicRecordingApi/README.md +++ b/google-services/Fitness/BasicRecordingApi/README.md @@ -1,21 +1,31 @@ -Android Fit Recording Api Sessions Sample -========================================= +--- +name: Xamarin.Android - Android Fit Recording Api Sessions Sample +description: This sample demonstrates how to use the Android Fit Recording API. Instructions Make sure to enable 'Google Sign-In' for your application via the... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: google-services-fitness-basicrecordingapi +--- +# Android Fit Recording Api Sessions Sample This sample demonstrates how to use the Android Fit Recording API. -Instructions ------------- +## Instructions * Make sure to enable 'Google Sign-In' for your application via the [Developer Console](https://developers.google.com/mobile/add?platform=android). * Log into a Google account to display mock subscription data. -Build Requirements ------------------- +## Build Requirements Using this sample requires the Android SDK platform for Android 5.0 (API level 21). -Authors -------- +![Android Fit Recording Api Sessions Sample application screenshot](Screenshots/screenshot1.png "Android Fit Recording Api Sessions Sample application screenshot") + +## Authors Copyright (c) 2015 Google, Inc. Ported from [Android Fit Recording Api Sessions Sample](https://github.com/googlesamples/android-fit/tree/master/BasicRecordingApi) diff --git a/google-services/Fitness/BasicSensorsApi/README.md b/google-services/Fitness/BasicSensorsApi/README.md index 0da0a7c16..1ce857fd8 100644 --- a/google-services/Fitness/BasicSensorsApi/README.md +++ b/google-services/Fitness/BasicSensorsApi/README.md @@ -1,21 +1,31 @@ -Android Fit Sensors Api Sample -======================================= +--- +name: Xamarin.Android - Android Fit Sensors Api Sample +description: This sample demonstrates how to use the Android Fit Sensors API. Instructions Make sure to enable 'Google Sign-In' for your application via the... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: google-services-fitness-basicsensorsapi +--- +# Android Fit Sensors Api Sample This sample demonstrates how to use the Android Fit Sensors API. -Instructions ------------- +## Instructions * Make sure to enable 'Google Sign-In' for your application via the [Developer Console](https://developers.google.com/mobile/add?platform=android). * Log into a Google account to display mock sensor data. -Build Requirements ------------------- +## Build Requirements Using this sample requires the Android SDK platform for Android 5.0 (API level 21). -Authors -------- +![Android Fit Sensors Api Sample application screenshot](Screenshots/screenshot1.png "Android Fit Sensors Api Sample application screenshot") + +## Authors Copyright (c) 2015 Google, Inc. Ported from [Android Fit Sensors Api Sample](https://github.com/googlesamples/android-fit/tree/master/BasicSensorsApi) diff --git a/google-services/GCMSample/README.md b/google-services/GCMSample/README.md index 240df65c2..e0dfee968 100644 --- a/google-services/GCMSample/README.md +++ b/google-services/GCMSample/README.md @@ -1,10 +1,20 @@ -Google Cloud Messaging Sample -============================= +--- +name: Xamarin.Android - Google Cloud Messaging Sample +description: This sample demonstrates how to use Google Cloud Messaging to register an Android app for GCM and handle the receipt of a GCM message. Instructions... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: google-services-gcmsample +--- +# Google Cloud Messaging Sample This sample demonstrates how to use Google Cloud Messaging to register an Android app for GCM and handle the receipt of a GCM message. -Instructions ------------- +## Instructions * Authorize your app in the Google Developers Console (link below) to get your API Key and Sender ID * Replace the value for `gcm_defaultSenderId` in `GCMSample/Resources/values/strings.xml` with your Sender ID. * Replace the value for `API_KEY` in `GcmSender/GcmSender.cs` with your API Key. @@ -13,18 +23,17 @@ Instructions * Send a message using the console application project while the app is still open. * Observe the notification being sent to your device/emulator. -Troubleshooting ---------------- +## Troubleshooting Note: Make sure you've authorized the app in the [Google Developers Console](https://developers.google.com/mobile/add) before use. -Build Requirements ------------------- +## Build Requirements Using this sample requires the Android SDK platform for Android 5.0 (API level 21). -Authors -------- +![Google Cloud Messaging Sample application screenshot](Screenshots/Screenshot1.png "Google Cloud Messaging Sample application screenshot") + +## Authors Copyright (c) 2015 Google, Inc. Ported from [Google Cloud Messaging Sample](https://github.com/googlesamples/google-services/tree/master/android/gcm) diff --git a/google-services/Location/ActivityRecognition/README.md b/google-services/Location/ActivityRecognition/README.md index 3347256c0..b744aa8b1 100644 --- a/google-services/Location/ActivityRecognition/README.md +++ b/google-services/Location/ActivityRecognition/README.md @@ -1,22 +1,32 @@ -Activity Recognition Sample -=========================== +--- +name: Xamarin.Android - Activity Recognition Sample +description: This sample demonstrates how to use the ActivityRecognitionApi to recognize a user's current activity type (e.g. walking, driving, or standing... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: google-services-location-activityrecognition +--- +# Activity Recognition Sample This sample demonstrates how to use the ActivityRecognitionApi to recognize a user's current activity type (e.g. walking, driving, or standing still). -Instructions ------------- +## Instructions * Tap the "Request Updates" button to begin receiving activity updates. * While the app is running, update information will begin to populate. * Tap the "Remove Updates" button to stop receiving updates and clear existing activity data. -Build Requirements ------------------- +## Build Requirements Using this sample requires the Android SDK platform for Android 5.0 (API level 21). -Authors -------- +![Activity Recognition Sample application screenshot](Screenshots/screenshot1.png "Activity Recognition Sample application screenshot") + +## Authors Copyright (c) 2015 Google, Inc. Ported from [Recognizing the User's Current Activity Sample](https://github.com/googlesamples/android-play-location/tree/master/ActivityRecognition) diff --git a/google-services/Location/BasicLocationSample/README.md b/google-services/Location/BasicLocationSample/README.md index feb4fdc11..80b478d91 100644 --- a/google-services/Location/BasicLocationSample/README.md +++ b/google-services/Location/BasicLocationSample/README.md @@ -1,20 +1,30 @@ -Basic Location Sample -===================== +--- +name: Xamarin.Android - Basic Location Sample +description: This sample demonstrates how to use the Google Play services Location API to retrieve the last known location for a device. Instructions Launch the... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: google-services-location-basiclocationsample +--- +# Basic Location Sample This sample demonstrates how to use the Google Play services Location API to retrieve the last known location for a device. -Instructions ------------- +## Instructions * Launch the app to view the last known course location of the device. -Build Requirements ------------------- +## Build Requirements Using this sample requires the Android SDK platform for Android 5.0 (API level 21). -Authors -------- +![Basic Location Sample application screenshot](Screenshots/screenshot1.png "Basic Location Sample application screenshot") + +## Authors Copyright (c) 2015 Google, Inc. Ported from [Basic Location Sample](https://github.com/googlesamples/android-play-location/tree/master/BasicLocationSample) diff --git a/google-services/Location/Geofencing/README.md b/google-services/Location/Geofencing/README.md index 32071b91a..cb48389b5 100644 --- a/google-services/Location/Geofencing/README.md +++ b/google-services/Location/Geofencing/README.md @@ -1,22 +1,32 @@ -Geofencing Sample -================= +--- +name: Xamarin.Android - Geofencing Sample +description: This sample demonstrates how to create and remove geofences using the GeofencingApi. Instructions Modify the LatLng dictionary in Constants.cs to... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: google-services-location-geofencing +--- +# Geofencing Sample This sample demonstrates how to create and remove geofences using the GeofencingApi. -Instructions ------------- +## Instructions * Modify the LatLng dictionary in Constants.cs to include locations near you. * Launch the app, and tap 'Add Geofences'. * A notification will be displayed when one of the geofences is entered. -Build Requirements ------------------- +## Build Requirements Using this sample requires the Android SDK platform for Android 5.0 (API level 21). -Authors -------- +![Geofencing Sample application screenshot](Screenshots/screenshot1.png "Geofencing Sample application screenshot") + +## Authors Copyright (c) 2015 Google, Inc. Ported from [Creating and Monitoring Geofences](https://github.com/googlesamples/android-play-location/tree/master/Geofencing) Ported to Xamarin.Android by Aaron Sky \ No newline at end of file diff --git a/google-services/Location/LocationAddress/README.md b/google-services/Location/LocationAddress/README.md index a36087391..6fcd9c74a 100644 --- a/google-services/Location/LocationAddress/README.md +++ b/google-services/Location/LocationAddress/README.md @@ -1,20 +1,30 @@ -Location Address Sample -======================= +--- +name: Xamarin.Android - Location Address Sample +description: This sample demonstrates how to use the Geocode API and reverse geocoding to display a device's location as an address. Instructions Tap the Fetch... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: google-services-location-locationaddress +--- +# Location Address Sample This sample demonstrates how to use the Geocode API and reverse geocoding to display a device's location as an address. -Instructions ------------- +## Instructions * Tap the "Fetch Address" button to display the nearest address to your current location. -Build Requirements ------------------- +## Build Requirements Using this sample requires the Android SDK platform for Android 5.0 (API level 21). -Authors -------- +![Location Address Sample application screenshot](Screenshots/screenshot1.png "Location Address Sample application screenshot") + +## Authors Copyright (c) 2015 Google, Inc. Ported from [Location Address Sample](https://github.com/googlesamples/android-play-location/tree/master/LocationAddress) diff --git a/google-services/Location/LocationSettings/README.md b/google-services/Location/LocationSettings/README.md index dc81a2bd0..123c2eb63 100644 --- a/google-services/Location/LocationSettings/README.md +++ b/google-services/Location/LocationSettings/README.md @@ -1,22 +1,32 @@ -Location Settings Sample -================= +--- +name: Xamarin.Android - Location Settings Sample +description: This sample demonstrates how to use the Location SettingsApi to check if a device has the location settings required by an application, and... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: google-services-location-locationsettings +--- +# Location Settings Sample This sample demonstrates how to use the Location SettingsApi to check if a device has the location settings required by an application, and optionally provide a location dialog to update the device's location settings. -Instructions ------------- +## Instructions * Tap the "Start Updates" button to start receiving location updates. * Tap the "Stop Updates" button to stop receiving location updates. -Build Requirements ------------------- +## Build Requirements Using this sample requires the Android SDK platform for Android 5.0 (API level 21). -Authors -------- +![Location Settings Sample application screenshot](Screenshots/screenshot1.png "Location Settings Sample application screenshot") + +## Authors Copyright (c) 2015 Google, Inc. Ported from [Location Settings Sample](https://github.com/googlesamples/android-play-location/tree/master/LocationSettings) diff --git a/google-services/Location/LocationUpdates/README.md b/google-services/Location/LocationUpdates/README.md index a06ae85f2..01739f204 100644 --- a/google-services/Location/LocationUpdates/README.md +++ b/google-services/Location/LocationUpdates/README.md @@ -1,21 +1,31 @@ -Location Updates Sample -================= +--- +name: Xamarin.Android - Location Updates Sample +description: This sample demonstrates how to use the Fused Location Provider API to get updates about a device's location. Instructions Tap the Start Updates... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: google-services-location-locationupdates +--- +# Location Updates Sample This sample demonstrates how to use the Fused Location Provider API to get updates about a device's location. -Instructions ------------- +## Instructions * Tap the "Start Updates" button to start receiving location updates. * Tap the "Stop Updates" button to stop receiving location updates. -Build Requirements ------------------- +## Build Requirements Using this sample requires the Android SDK platform for Android 5.0 (API level 21). -Authors -------- +![Location Updates Sample application screenshot](Screenshots/screenshot1.png "Location Updates Sample application screenshot") + +## Authors Copyright (c) 2015 Google, Inc. Ported from [Location Updates Sample](https://github.com/googlesamples/android-play-location/tree/master/LocationUpdates) diff --git a/google-services/Nearby/ConnectionsQuickstart/README.md b/google-services/Nearby/ConnectionsQuickstart/README.md index 4d655ee84..1efb3f892 100644 --- a/google-services/Nearby/ConnectionsQuickstart/README.md +++ b/google-services/Nearby/ConnectionsQuickstart/README.md @@ -1,24 +1,33 @@ -Nearby Connections Sample -================= +--- +name: Xamarin.Android - Nearby Connections Sample +description: This sample demonstrates how to use the Nearby Connections API to establish a connection between two devices and send messages between them.... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: google-services-nearby-connectionsquickstart +--- +# Nearby Connections Sample This sample demonstrates how to use the Nearby Connections API to establish a connection between two devices and send messages between them. -Prerequisites -------------- +## Prerequisites * Requires two devices running Android 4.4 "KitKat" or higher. -Instructions ------------- +## Instructions * Tap the "Advertise" button on one device running the app. * Tap the "Discover" button on the other device running the app in order to discover the first device. -Build Requirements ------------------- +## Build Requirements Using this sample requires the Android SDK platform for Android 5.0 (API level 21). -Authors -------- +![Nearby Connections Sample application screenshot](Screenshots/Screenshot1.png "Nearby Connections Sample application screenshot") + +## Authors Copyright (c) 2015 Google, Inc. Ported from [Nearby Connections Quickstart Sample](https://github.com/googlesamples/android-nearby/tree/master/connections-quickstart) diff --git a/google-services/SigninQuickstart/README.md b/google-services/SigninQuickstart/README.md index 9ae86cc1e..3fd37099f 100644 --- a/google-services/SigninQuickstart/README.md +++ b/google-services/SigninQuickstart/README.md @@ -1,34 +1,42 @@ -Google Sign-In Sample -===================== +--- +name: Xamarin.Android - Google Sign-In Sample +description: This sample demonstrates how to authenticate a user with the Google Api Client in Google Play Services. Setup You must follow the next guide to... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: google-services-signinquickstart +--- +# Google Sign-In Sample This sample demonstrates how to authenticate a user with the Google Api Client in Google Play Services. -Setup ------ +## Setup * You must follow the next guide to configure the Sign-In feature: https://developers.google.com/identity/sign-in/android/start * On Step 2 (Configuration File), you can open [this URL](https://developers.google.com/mobile/add?platform=android&cntapi=signin&cntapp=SignInQuickstart&cntpkg=com.xamarin.signinquickstart&cnturl=https:%2F%2Fdevelopers.google.com%2Fidentity%2Fsign-in%2Fandroid%2Fstart%3Fconfigured%3Dtrue&cntlbl=Continue%20with%20Try%20Sign-In) for this specific sample. * Replace the google-services.json file by your generated file. -Instructions ------------- +## Instructions * Tap the "Sign in with Google" button to sign in. * Tap the "Sign Out" button to sign out of the current session. * Tap "Disconnect" button to disconnect sign in with the app. -Troubleshooting ---------------- +## Troubleshooting * DEVELOPER_ERROR: Make sure you're using the generated android debug keystore by Xamarin for generate SHA-1. Check [this article](https://developer.xamarin.com/guides/android/deployment,_testing,_and_metrics/MD5_SHA1/) to get it. Note: Make sure you've authorized the app in the [Google Developers Console](https://console.developers.google.com/project) before use. -Build Requirements ------------------- +## Build Requirements Using this sample requires the Android SDK platform for Android 5.0+ (API level 21). -Authors -------- +![Google Sign-In Sample application screenshot](Screenshots/promt.png "Google Sign-In Sample application screenshot") + +## Authors Copyright (c) 2015 Google, Inc. Ported from [Google Sign-In Sample](https://developers.google.com/mobile/add) diff --git a/tv/TvLeanback/README.md b/tv/TvLeanback/README.md index 54f77c440..3d63be3bb 100644 --- a/tv/TvLeanback/README.md +++ b/tv/TvLeanback/README.md @@ -1,18 +1,28 @@ -TvLeanback -========== +--- +name: Xamarin.Android - TvLeanback +description: 'This sample shows a basic Android-TV application by showcasing various video provided by Google. Note: This sample may crash due to a bug in the...' +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: tv-tvleanback +--- +# TvLeanback This sample shows a basic Android-TV application by showcasing various video provided by Google. -Note: ------ +## Note: This sample may crash due to a [bug](https://code.google.com/p/android/issues/detail?id=73920) in the native Android System. -Build Requirements: --------------- +## Build Requirements: This sample is designed for Android-TV but can run on the Android L developer preview. It also requires Xamarin.Android 4.17+. -Author: --------- +![TvLeanback application screenshot](Screenshots/home.png "TvLeanback application screenshot") + +## Author: This project relies on the Picasso Project by Jake Warton and is used under the Apache License Version 2. The C# bindings used by this app were created by Jack Sierkstra. The original project by Jake Warton is available from: https://github.com/square/picasso The bindings are available from: https://github.com/jacksierkstra/Picasso diff --git a/tv/VisualGameController/README.md b/tv/VisualGameController/README.md index 35ff038ac..aab671bf9 100644 --- a/tv/VisualGameController/README.md +++ b/tv/VisualGameController/README.md @@ -1,17 +1,27 @@ -Visual Game Controller -================== +--- +name: Xamarin.Android - Visual Game Controller +description: This AndroidTV sample demonstrates the use of input from a game controller by displaying input events on the screen on a virtual controller as they... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: tv-visualgamecontroller +--- +# Visual Game Controller This AndroidTV sample demonstrates the use of input from a game controller by displaying input events on the screen on a virtual controller as they happen. -Instructions ------------- +## Instructions * Press buttons and move axes on an attached game controller and the input that you give will be recreated on-screen. * Keep in mind that the button mapping is different for different types of game controllers. The sample has the differences between Xbox game controllers and Android game controllers in the comments as the item in question is drawn. -Build Requirements ------------------- +## Build Requirements Using this sample requires an android tv or android l device and Xamarin.Android version 4.17 or later. -Author ------- +![Visual Game Controller application screenshot](Screenshots/Screenshot1.png "Visual Game Controller application screenshot") + +## Author Copyright (c) 2005-2008, The Android Open Source Project Ported to Xamarin.Android by John Pilczak diff --git a/wear/AgendaData/README.md b/wear/AgendaData/README.md index dacbfe0d1..5473b5fb9 100644 --- a/wear/AgendaData/README.md +++ b/wear/AgendaData/README.md @@ -1,20 +1,30 @@ -AgendaData Sample -================= +--- +name: Xamarin.Android - AgendaData Sample +description: This sample demonstrates sending calendar events from an Android handheld device to an Android Wear device, as well as deleting those events.... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: wear-agendadata +--- +# AgendaData Sample This sample demonstrates sending calendar events from an Android handheld device to an Android Wear device, as well as deleting those events. -Instructions ------------- +## Instructions * Launch the AgendaData project onto the phone or tablet and the Wearable project onto the wearable device * If you have no calendar events on the phone or tablet, make one * Press the "Sync calendar events to wearable" button to add your calendar events to the wearable * Press the "Delete calendar events from wearable" to delete the events from the wearable -Build Requirements ------------------- +## Build Requirements Xamarin Studio 5.3+ Xamarin.Android 4.17+ -Author -------- +![AgendaData Sample application screenshot](Screenshots/Default view.png "AgendaData Sample application screenshot") + +## Author Copyright (c) 2005-2008, The Android Open Source Project Ported to Xamarin.Android by Christopher Blackman diff --git a/wear/DataLayer/README.md b/wear/DataLayer/README.md index 8ae06f33c..e0550856d 100644 --- a/wear/DataLayer/README.md +++ b/wear/DataLayer/README.md @@ -1,15 +1,24 @@ -DataLayer Sample -================ +--- +name: Xamarin.Android - DataLayer Sample +description: This sample demonstrates using the wearable APIs to send messages and stream data (an image in this sample) from an Android device to an Android... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: wear-datalayer +--- +# DataLayer Sample This sample demonstrates using the wearable APIs to send messages and stream data (an image in this sample) from an Android device to an Android Wear device. -Instructions ------------- +## Instructions * Download Xamarin Studio 5.3 or higher and open the project solution. Right click the project DataLayer and set it as the startup project, then click build in the application menu. Then right click the project Wearable, set it as the startup project, then click build in the application menu. * You will need to deploy DataLayer to a physical Android device running at least Android 4.3 Jelly Bean. Wearable can be deployed to either an Android Wear device or the Android Wear emulator. -Build requirements -------------------- +## Build requirements Xamarin Studio 5.3+ Xamarin.Android 4.17+ The DataLayer project must be deployed to a physical android device of at least Android 4.3 Jelly bean and the Wearable project must be deployed to either an Android Wear device or emulator. @@ -18,7 +27,8 @@ Download Xamarin Studio 5.3 or higher and open the project solution. Right click You will need to deploy DataLayer to a physical Android device running at least Android 4.3 Jelly Bean. Wearable can be deployed to either an Android Wear device or the Android Wear emulator. -Author ------- +![DataLayer Sample application screenshot](Screenshots/Log and Thumbnail.png "DataLayer Sample application screenshot") + +## Author Copyright (c) 2005-2008, The Android Open Source Project Ported to Xamarin.Android by Christopher Blackman diff --git a/wear/DelayedConfirmation/README.md b/wear/DelayedConfirmation/README.md index bd3d58652..91176ac06 100644 --- a/wear/DelayedConfirmation/README.md +++ b/wear/DelayedConfirmation/README.md @@ -1,22 +1,32 @@ -Delayed Confirmation -====================== +--- +name: Xamarin.Android - Delayed Confirmation +description: A simple sample which demonstrates how to send and receive messages to a connected Wearable using the new Wear APIs. Ported from the Android Open... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: wear-delayedconfirmation +--- +# Delayed Confirmation A simple sample which demonstrates how to send and receive messages to a connected Wearable using the new Wear APIs. Ported from the Android Open Source Project sample -Note ----- +## Note For running on an emulator for wearable, you must run ```shell adb -d forward tcp:5601 tcp:5601 ``` Full instructions for how to connect and prepare a Wearable for use please see [Android Developers](http://developer.android.com/training/wearables/apps/creating.html#SetupEmulator) -Build Requirements ------------------- +## Build Requirements Xamarin.Android 4.17+ Xamarin Studio 5.3+ -Author ------- +![Delayed Confirmation application screenshot](Screenshots/handheld.png "Delayed Confirmation application screenshot") + +## Author Android Open Source Project (original Java) Ported to Xamarin.Android by Ben O'Halloran diff --git a/wear/ElizaChat/README.md b/wear/ElizaChat/README.md index 2c78b994b..5df19b8ce 100644 --- a/wear/ElizaChat/README.md +++ b/wear/ElizaChat/README.md @@ -1,23 +1,33 @@ -ElizaChat -====================== +--- +name: Xamarin.Android - ElizaChat +description: A wear sample demonstrating how a personal assistant may work on a wearable device. The user interacts with Eliza, the personal assistant, through... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: wear-elizachat +--- +# ElizaChat A wear sample demonstrating how a personal assistant may work on a wearable device. The user interacts with Eliza, the personal assistant, through Wear's interactive notifications. The main application serves as a log of the different interactions. -Note ----- +## Note For running on an emulator for wearable, please run ```shell adb -d forward tcp:5601 tcp:5601 ``` For full instructions for how to connect and prepare a Wearable for use please see [Android Developers](http://developer.android.com/training/wearables/apps/creating.html#SetupEmulator) -Build Requirements ------------------- +## Build Requirements Xamarin.Android 4.17+ Xamarin Studio 5.3+ -Author ------- +![ElizaChat application screenshot](Screenshots/notification-muted.png "ElizaChat application screenshot") + +## Author Android Open Source Project (original Java) Ported to Xamarin.Android by Ben O'Halloran diff --git a/wear/FindMyPhoneSample/README.md b/wear/FindMyPhoneSample/README.md index 0132befe6..e1add4a0e 100644 --- a/wear/FindMyPhoneSample/README.md +++ b/wear/FindMyPhoneSample/README.md @@ -1,9 +1,19 @@ -FindMyPhone -================ +--- +name: Xamarin.Android - FindMyPhone +description: This sample demonstrates a way to create an app that allows you to use your wear device to find your phone. Instructions Download Xamarin Studio... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: wear-findmyphonesample +--- +# FindMyPhone This sample demonstrates a way to create an app that allows you to use your wear device to find your phone. -Instructions ------------- +## Instructions * Download Xamarin Studio 5.3 or higher and open the project solution. Right click the project “Application” and set it as the startup project, then click build in the application menu. Then right click the project “Wearable”, set it as the startup project, then click build in the application menu. * You will need to deploy DataLayer to a physical Android device running at least Android 4.3 Jelly Bean. Wearable can be deployed to either an Android Wear device or the Android Wear emulator. @@ -14,12 +24,12 @@ Instructions * Note - This will sometimes also happen when dismissing the notification via swipe. It should go away after ten seconds or so. -Build requirements -------------------- +## Build requirements Xamarin Studio 5.3+ Xamarin.Android 4.17+ -Author ------- +![FindMyPhone application screenshot](Screenshots/Find Phone.png "FindMyPhone application screenshot") + +## Author Copyright (c) 2005-2008, The Android Open Source Project Ported to Xamarin.Android by John Pilczak diff --git a/wear/FlashlightSample/README.md b/wear/FlashlightSample/README.md index a791f0adb..2f80a0d52 100644 --- a/wear/FlashlightSample/README.md +++ b/wear/FlashlightSample/README.md @@ -1,19 +1,29 @@ -Flashlight -===== +--- +name: Xamarin.Android - Flashlight +description: This sample demonstrates how to create something similar to a flashlight on an android wear device by changing the color of the screen to a flat... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: wear-flashlightsample +--- +# Flashlight This sample demonstrates how to create something similar to a flashlight on an android wear device by changing the color of the screen to a flat white color. This also includes a “party light” which can be accessed by swiping left which would replace the flat white color with a flashing cycle of many colors. -Instructions ------------- +## Instructions * The default page is a white light * Swipe left to change to the party light which cycles through many colors -Build Requirements ------------------- +## Build Requirements Xamarin.Android 4.17+ Xamarin Studio 5.3+ -Author ------- +![Flashlight application screenshot](Screenshots/party_light.png "Flashlight application screenshot") + +## Author Copyright (c) 2005-2008, The Android Open Source Project Ported to Xamarin.Android by John Pilczak diff --git a/wear/Geofencing/README.md b/wear/Geofencing/README.md index ce1b66c8e..ea29eb221 100644 --- a/wear/Geofencing/README.md +++ b/wear/Geofencing/README.md @@ -1,20 +1,30 @@ -Geofencing Wearable Sample -=========================== +--- +name: Xamarin.Android - Geofencing Wearable Sample +description: This sample demonstrates the use of geofencing with wearable devices, by sending a notification to the watch when you are within a certain area.... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: wear-geofencing +--- +# Geofencing Wearable Sample This sample demonstrates the use of geofencing with wearable devices, by sending a notification to the watch when you are within a certain area. -Instructions -------------------- +## Instructions * Deploy the project called "Geofencing" to your phone or tablet, and the project called "Wearable" to your Android Wear device. * When you enter the specified coordinates in the constants class, a notification will be sent to the wearable. * When testing this sample you may need to change the coordinates in the class Constants in the "Geofencing" project to coordinates that are closer to your location. Changing the values YERBA_BUENA_LATITUDE and YERBA_BUENA_LONGITUDE should work. -Build Requirements ------------------- +## Build Requirements In order to build this solution, you will need the latest version of Xamarin Studio. This sample requires a physical Android 4.3 or higher device, that is connected to an Android Wear device or the Android Wear emulator. -Author -------- +![Geofencing Wearable Sample application screenshot](Screenshots/Starting geofence transition service.png "Geofencing Wearable Sample application screenshot") + +## Author Copyright (c) 2005-2008, The Android Open Source Project Ported to Xamarin.Android by Christopher Blackman diff --git a/wear/GridViewPager/README.md b/wear/GridViewPager/README.md index b1ce4701b..b3135a9a5 100644 --- a/wear/GridViewPager/README.md +++ b/wear/GridViewPager/README.md @@ -1,17 +1,28 @@ -GridViewPager sample -==================== +--- +name: Xamarin.Android - GridViewPager sample +description: This sample demonstrates how to use the GridViewPager and GridPagerAdapter view for Android Wear devices. GridViewPager is a view that separates... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: wear-gridviewpager +--- +# GridViewPager sample This sample demonstrates how to use the GridViewPager and GridPagerAdapter view for Android Wear devices. GridViewPager is a view that separates each item onto a different page, and can be swiped through horizontally or vertically. An implementation of GridViewAdapter is included to supply the GridViewPager with views. GridViewPager is very similar to the notifications layout on the Android Wear home screen. As such, each page / item may have a background, and the control will automatically perform parallax effects between the foreground and background. -Build Requirements ------------------- +## Build Requirements Xamarin Studio 5.3+ Xamarin.Android 4.17+ -Author ------- +![GridViewPager sample application screenshot](Screenshots/About.png "GridViewPager sample application screenshot") + +## Author Copyright (c) 2005-2008, The Android Open Source Project Ported to Xamarin.Android by Christopher Blackman diff --git a/wear/JumpingJack/README.md b/wear/JumpingJack/README.md index 63fb10062..423555e88 100644 --- a/wear/JumpingJack/README.md +++ b/wear/JumpingJack/README.md @@ -1,19 +1,29 @@ -Jumping Jack -================== +--- +name: Xamarin.Android - Jumping Jack +description: This sample demonstrates the use of the gravity sensor in the Android Wear device through a counter for jumping jacks that the user makes while... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: wear-jumpingjack +--- +# Jumping Jack This sample demonstrates the use of the gravity sensor in the Android Wear device through a counter for jumping jacks that the user makes while wearing the device. Note: the jumping jacks must be fairly quick (2 seconds or less) for the jumping jacks to count. The counter can be reset from the settings screen accessed by swiping left. -Instructions ------------- +## Instructions * Deploy the wearable project onto an Android Wear device. * The first page will count the number of jumping jacks you do. * The second page (reached by swiping left) will contain a button allowing you to reset the counter. -Build Requirements ------------------- +## Build Requirements Xamarin Studio 5.3+ Xamarin.Android 4.17+ -Author ------- +![Jumping Jack application screenshot](Screenshots/reset.png "Jumping Jack application screenshot") + +## Author Copyright (c) 2005-2008, The Android Open Source Project Ported to Xamarin.Android by John Pilczak diff --git a/wear/Quiz/README.md b/wear/Quiz/README.md index a0e108cbf..b076a35e6 100644 --- a/wear/Quiz/README.md +++ b/wear/Quiz/README.md @@ -1,9 +1,19 @@ -Quiz -================== +--- +name: Xamarin.Android - Quiz +description: This wearable sample demonstrates how to create a quiz between the watch and the mobile device. The phone app will allow you to either create a... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: wear-quiz +--- +# Quiz This wearable sample demonstrates how to create a quiz between the watch and the mobile device. The phone app will allow you to either create a custom quiz or load questions from a file. Once a question is added, the wearable device will display the question and allow the user to answer by tapping the page of the notification that appears that they think is the right answer. -Instructions ------------- +## Instructions * Create a quiz on the phone app by either tapping the “Read quiz from file” button or by filling in the blanks with your own question and selecting the correct answer’s radio button then pressing the “Add question” button. * Answer questions made on the phone app by swiping until you see the answer you think is correct and tapping that answer. The question will turn either green or red on the phone app showing whether you are right or wrong. @@ -12,11 +22,11 @@ Instructions * “New Quiz” will clear all current questions allowing you to create a completely new quiz -Build Requirements ------------------- +## Build Requirements This app requires both a wear device and a phone/tablet that is api level 18+ to run. You also need Xamarin.Android 4.17 or later. -Author ------- +![Quiz application screenshot](Screenshots/Quiz maker.png "Quiz application screenshot") + +## Author Copyright (c) 2005-2008, The Android Open Source Project Ported to Xamarin.Android by John Pilczak \ No newline at end of file diff --git a/wear/RecipeAssistant/README.md b/wear/RecipeAssistant/README.md index bab8f7079..6cdba4aed 100644 --- a/wear/RecipeAssistant/README.md +++ b/wear/RecipeAssistant/README.md @@ -1,19 +1,29 @@ -RecipeAssistant -=============== +--- +name: Xamarin.Android - RecipeAssistant +description: This sample demonstrates sending a list of notifications pages to an Android Wear device, with each page describing a step in a recipe. The actual... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: wear-recipeassistant +--- +# RecipeAssistant This sample demonstrates sending a list of notifications pages to an Android Wear device, with each page describing a step in a recipe. The actual creation of the notification is done in RecipeService.cs. -Instructions ------------- +## Instructions * Deploy the RecipeAssistant project to a physical Android device that is 4.3 Jelly Bean or above. * Pick a recipe from the app to send to the wearable device * The wearable device will recieve a multi-page notification with a page for each step of the recipe. You can move on to the next page by swiping left on the device. -Build Requirements ------------------- +## Build Requirements Xamarin Studio 5.3+ Xamarin.Android 4.17+ -Author ------- +![RecipeAssistant application screenshot](Screenshots/Recipe List.png "RecipeAssistant application screenshot") + +## Author Copyright (c) 2005-2008, The Android Open Source Project Ported to Xamarin.Android by Christopher Blackman diff --git a/wear/SkeletonWear/README.md b/wear/SkeletonWear/README.md index adb589c0f..6a2c6ff97 100644 --- a/wear/SkeletonWear/README.md +++ b/wear/SkeletonWear/README.md @@ -1,13 +1,24 @@ -SkeletonWear -============ +--- +name: Xamarin.Android - SkeletonWear +description: This sample shows the basic outline of a wearable project including Gridviews on Wearable devices and interactive notifications. Build Requirements... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: wear-skeletonwear +--- +# SkeletonWear This sample shows the basic outline of a wearable project including Gridviews on Wearable devices and interactive notifications. -Build Requirements ------------------- +## Build Requirements Xamarin Studio 5.3+ Xamarin.Android 4.17+ -Author ------- +![SkeletonWear application screenshot](Screenshots/launch.png "SkeletonWear application screenshot") + +## Author Copyright (c) 2005-2008, The Android Open Source Project Ported to Xamarin.Android by Ben O'Halloran diff --git a/wear/SynchronizedNotifications/README.md b/wear/SynchronizedNotifications/README.md index 6fa102b02..7b97b9cbb 100644 --- a/wear/SynchronizedNotifications/README.md +++ b/wear/SynchronizedNotifications/README.md @@ -1,18 +1,28 @@ -SynchronizedNotifications -==================== +--- +name: Xamarin.Android - SynchronizedNotifications +description: This wearable sample demonstrates using listener services to create three kinds of notifications; a phone only notification, a wearable only... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: wear-synchronizednotifications +--- +# SynchronizedNotifications This wearable sample demonstrates using listener services to create three kinds of notifications; a phone only notification, a wearable only notification, and a notification that appears on both the phone and wearable, with one automatically disappearing when the other is dismissed. -Instructions ------------- +## Instructions * Deploy the SynchronizedNotifications project to a 4.3 Jelly Bean or higher Android device and the Wearable project to an Android Wear device. * Choose an item from the list to send notifications to the listed devices. -Build Requirements ------------------- +## Build Requirements Xamarin Studio 5.3+ Xamarin.Android 4.17+ -Author ------- +![SynchronizedNotifications application screenshot](Screenshots/App view.png "SynchronizedNotifications application screenshot") + +## Author Copyright (c) 2005-2008, The Android Open Source Project Ported to Xamarin.Android by Christopher Blackman diff --git a/wear/Timer/README.md b/wear/Timer/README.md index 828c857ea..c5d35073c 100644 --- a/wear/Timer/README.md +++ b/wear/Timer/README.md @@ -1,22 +1,32 @@ -Timer -- DEPRECATED -===== +--- +name: Xamarin.Android - Timer -- DEPRECATED +description: A simple timer application designed for Wear. The timer is displayed as a notification with reset and delete options. Instructions Launch the app... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: wear-timer +--- +# Timer -- DEPRECATED A simple timer application designed for Wear. The timer is displayed as a notification with reset and delete options. -Instructions ------------- +## Instructions * Launch the app onto a wearable device. * Pick a time from the list that you want the timer to be set to. * Swipe up to see the notification that appears with the timer. * Swipe left to get to the reset and delete buttons. -Build Requirements ------------------- +## Build Requirements * Xamarin.Android 4.20 * JDK 1.7 -Author ------- +![Timer -- DEPRECATED application screenshot](Screenshots/Delete.png "Timer -- DEPRECATED application screenshot") + +## Author Copyright (c) 2005-2008, The Android Open Source Project diff --git a/wear/WatchFace/README.md b/wear/WatchFace/README.md index 4ee95f19b..3de6fd033 100644 --- a/wear/WatchFace/README.md +++ b/wear/WatchFace/README.md @@ -1,5 +1,16 @@ -WatchFace -========= +--- +name: Xamarin.Android - WatchFace +description: WatchFace is a sample app that accompanies the article, Creating a Watch Face. This sample demonstrates how to use CanvasWatchFaceService and... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: wear-watchface +--- +# WatchFace **WatchFace** is a sample app that accompanies the article, [Creating a Watch Face](https://developer.xamarin.com/guides/android/wear/creating-a-watchface/). diff --git a/wear/WatchViewStub/README.md b/wear/WatchViewStub/README.md index 44e8fecfc..6d953e677 100644 --- a/wear/WatchViewStub/README.md +++ b/wear/WatchViewStub/README.md @@ -1,13 +1,24 @@ -WatchViewStubSample -=================== +--- +name: Xamarin.Android - WatchViewStubSample +description: This wearable-only sample demonstrate using the WatchViewStub control which will automatically select a layout suited for round or rectangular... +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: wear-watchviewstub +--- +# WatchViewStubSample This wearable-only sample demonstrate using the WatchViewStub control which will automatically select a layout suited for round or rectangular screens. Take a look at the 'Resources/layout/main_actvity.xml' layout file to see how this is done. -Build Requirements ------------------- +## Build Requirements Xamarin Studio 5.3+ Xamarin.Android 4.17+ -Author ------- +![WatchViewStubSample application screenshot](Screenshots/Main View.png "WatchViewStubSample application screenshot") + +## Author Copyright (c) 2005-2008, The Android Open Source Project Ported to Xamarin.Android by Christopher Blackman diff --git a/wear/WearTest/README.md b/wear/WearTest/README.md index 548ecc133..c2405f221 100644 --- a/wear/WearTest/README.md +++ b/wear/WearTest/README.md @@ -1,5 +1,16 @@ -Android Wear Getting Started -============================ +--- +name: Xamarin.Android - Android Wear Getting Started +description: This sample app accompanies the Android Wear article, Getting Started. +page_type: sample +languages: +- csharp +products: +- xamarin +technologies: +- xamarin-android +urlFragment: wear-weartest +--- +# Android Wear Getting Started This sample app accompanies the Android Wear article, [Getting Started](https://developer.xamarin.com/guides/android/wear/getting-started/).