Xamarin.iOS sample apps
C# Objective-C Makefile GLSL F# HTML Other
Permalink
Failed to load latest commit information.
AQTapDemo no message Apr 27, 2015
AUSoundTriggeredPlayingSoundMemoryBased [AUSoundTriggeredPlayingSoundMemoryBased] Setup root view controller … Sep 11, 2015
AVCaptureFrames [AVCaptureFrames] Use CVOptionFlags in CVPixelBuffer.Lock: Mar 20, 2016
AVCompositionDebugVieweriOS no message Apr 27, 2015
AVCustomEdit [AVCustomEdit] fix #45778. Add NSPhotoLibraryUsageDescription key Oct 21, 2016
AVTouchSample Mass update of MinimumOSVersion value in Info.plist Nov 13, 2015
AirLocate Add required call and setting for iOS 8 Jun 11, 2015
AppPrefs [AppPrefs] Add bundle id Jan 18, 2016
ApplicationFundamentals [touch] docs samples moved out of ZIP (updated to Unified) Oct 14, 2015
AsyncDownloadImage Mass update of MinimumOSVersion value in Info.plist Nov 13, 2015
AudioConverterFileConverter Add brief description tag to metadata.xml Mar 23, 2015
AudioGenerator [AudioGenerator] Add minimum OS version Apr 27, 2015
AudioQueueOfflineRenderDemo Mass update of MinimumOSVersion value in Info.plist Nov 13, 2015
AudioTapProcessor [AudioTapProcessor] Add copyrights section Feb 19, 2016
BackgroundExecution Fix metadata file Sep 8, 2016
BindingSample Mono touch Samples - Readme Formatting Jun 4, 2015
BouncingGameCompleteiOS Fix metadata file Sep 8, 2016
BouncingGameEmptyiOS Fix metadata file Sep 8, 2016
BubbleCell [BubbleCell] deprecate sample May 6, 2015
ButtonEventDemo Fix metadata file Sep 8, 2016
ButtonTapper3000 [Chat] Remove redundant code Aug 25, 2016
Calendars Added privacy description needed on .plist Oct 4, 2016
Chat [Chat] Remove redundant code Aug 25, 2016
CircleLayout no message Apr 27, 2015
CollectionViewTransition Fix metadata file Sep 8, 2016
ContentControls removed duplicate samples, add moveto.md Feb 12, 2013
Controls Fix metadata file Sep 8, 2016
CoreAnimation Mass update of MinimumOSVersion value in Info.plist Nov 13, 2015
CoreImage Mass update of MinimumOSVersion value in Info.plist Nov 13, 2015
CoreLocation [Keychain][monocatalog][ExtensionsDemo][Touch][avTouch][reachability]… May 20, 2015
CoreMidiSample Resolving and clearing out warning messages Apr 27, 2015
CoreTelephonyDemo Fix metadata file Sep 8, 2016
CreatingTabbedApplications Fix metadata file Sep 8, 2016
CustomCollectionViewLayoutAttributes Further resolved warnings and errors in monotouch-samples Apr 28, 2015
CustomInputStream Mass update of MinimumOSVersion value in Info.plist Nov 13, 2015
CustomPropertyAnimation Mass update of MinimumOSVersion value in Info.plist Nov 13, 2015
Data [Data] bundleid should be set Aug 23, 2016
DesignerWalkthrough Fix metadata file Sep 8, 2016
DispatchSourceExamples Fix metadata file Sep 8, 2016
Drawing Mass update of MinimumOSVersion value in Info.plist Nov 13, 2015
DynamicsCatalog Fix metadata file Sep 8, 2016
EvolveGraphicsAndAnimation Adding readme for moved file. Nov 6, 2015
FileSystemSampleCode [Fix] Do not use 'Link All' to ensure that reflection works. Feb 26, 2016
FontList Fix metadata file Sep 8, 2016
FrogScroller [FrogScroller] Add bundle identifier and app name Jun 17, 2015
GLCameraRipple Added description for accessibility keys Oct 19, 2016
GLPaint-GameView Mass update of MinimumOSVersion value in Info.plist Nov 13, 2015
GameCenterSample Fix metadata file Sep 8, 2016
GoogleAdMobAds/binding Pull from upstream Jan 19, 2015
GraphicsAndAnimation [CoreGraphicsSamples] Fix architecture in Debug|iPhoneSimulator config: Mar 22, 2016
GrowRowTable Code cleaning Sep 29, 2016
HelloComponents Fix metadata file Sep 8, 2016
HelloWorld_iPhone Fix metadata file Sep 8, 2016
Hello_ComplexUniversal Mass update of MinimumOSVersion value in Info.plist Nov 13, 2015
Hello_MultiScreen_iPhone Fix metadata file Sep 8, 2016
Hello_Universal Fix metadata file Sep 8, 2016
Hello_iOS Fix metadata file Sep 8, 2016
Hello_iPad Fix metadata file Sep 8, 2016
HomeKit/HomeKitIntro iOS 10: Eliza Chat Oct 17, 2016
HttpClient Fix metadata file Sep 8, 2016
ImageProtocol Mass update of MinimumOSVersion value in Info.plist Nov 13, 2015
InfColorPicker [InfColorPicker] Recompile native library to target iOS 8.0 Sep 18, 2015
IntroToAppearance Fix metadata file Sep 8, 2016
IntroToiOS7 [LayoutWithNavController] Fix architecture in Debug|iPhoneSimulator c… Mar 22, 2016
IntroductionToiCloud Mass update of MinimumOSVersion value in Info.plist Nov 13, 2015
KeyValueObserving [KeyValueObserving] Observe View's layer changes, bug #29339 Apr 24, 2015
Keychain [Keychain] Add missing entitlement Sep 16, 2016
LazyTableImages Fix metadata file Sep 8, 2016
LazyTableImagesAsync Fix metadata file Sep 8, 2016
LifecycleDemo Mass update of MinimumOSVersion value in Info.plist Nov 13, 2015
LineLayout Further resolved warnings and errors in monotouch-samples Apr 28, 2015
LocalNotifications Updating sample Jul 12, 2016
Location adding PausesLocationUpdatesAutomatically property Dec 11, 2015
LowLevelGLPaint LowLevelGLPaint fix for Bug37416 Jun 16, 2016
MTDJsonDemo Fix metadata file Sep 8, 2016
MTDReflectionWalkthrough Fix metadata file Sep 8, 2016
MTDWalkthrough Fix metadata file Sep 8, 2016
MTGKTapper Fix metadata file Sep 8, 2016
ManualCameraControls Fixed crash related to capture bracket view Oct 5, 2016
ManualStoryboard Fix metadata file Sep 8, 2016
MapCallouts Fix metadata file Sep 8, 2016
MapDemo Fix metadata file Sep 8, 2016
MapKitSearch Further resolved warnings and errors in monotouch-samples Apr 28, 2015
MediaNotes Added description for accessibility keys Oct 19, 2016
MidiTest [Entitlements] Remove custom entitlements from project's configuration Jul 29, 2015
MonoCatalog-MonoDevelop Fix metadata file Sep 8, 2016
MonoCatalogSample Pull from upstream Jan 19, 2015
MonoDevelopTouchCells Fix metadata file Sep 8, 2016
MotionGraphs [MotionGraphs] Fix UIView ctor to be called from nib Jun 16, 2015
MoviePlayback Further resolved warnings and errors in monotouch-samples Apr 28, 2015
MultichannelMixer [Entitlements] Remove custom entitlements from project's configuration Jul 29, 2015
NSZombieApocalypse Mass update of MinimumOSVersion value in Info.plist Nov 13, 2015
Newsstand [Newsstand] Handle zero issues in NKLibrary Jun 20, 2016
Notifications Mass update of MinimumOSVersion value in Info.plist Nov 13, 2015
OpenGL Mass update of MinimumOSVersion value in Info.plist Nov 13, 2015
OpenGLESSample-GameView Fix metadata file Sep 8, 2016
OpenGLESSample Fix metadata file Sep 8, 2016
OpenGLScroller Add brief description tag to metadata.xml Mar 23, 2015
PaintCode Further resolved warnings and errors in monotouch-samples Apr 28, 2015
PassKit Add brief description tag to metadata.xml Mar 23, 2015
PinchIt Further resolved warnings and errors in monotouch-samples Apr 28, 2015
PokerNightVoting Add brief description tag to metadata.xml Mar 23, 2015
Popovers [Popovers] Add license file Feb 19, 2016
PrintBanner Add brief description tag to metadata.xml Mar 23, 2015
PrintSample Fix metadata file Sep 8, 2016
PrivacyPrompts Added description for accessibility keys Oct 19, 2016
Profiling/MemoryDemo [MemoryDemo] Add missing project configs Jun 20, 2016
Protocols_Delegates_Events [Entitlements] Remove custom entitlements from project's configuration Jul 29, 2015
QRchestra [QRchestra] Add NSCameraUsageDescription key to fix #43477 Aug 25, 2016
QuartzSample Fix metadata file Sep 8, 2016
Quotes Resolved warnings in Quotes sample May 5, 2015
ReachabilitySample Fix metadata file Sep 8, 2016
RecipesAndPrinting [RecipesAndPrinting] UIMarkupTextPrintFormatter is uikit class, so ct… Sep 17, 2015
RegionDefiner Resolved warnings in RegionDefiner sample May 5, 2015
RosyWriter Added description for accessibility keys Oct 19, 2016
Rotation Fix metadata file Sep 8, 2016
ScratchTicket Fix metadata file Sep 8, 2016
SearchDemo Fix metadata file Sep 8, 2016
SharedResources Added description for accessibility keys Oct 19, 2016
SimpleBackgroundFetch [SimpleBackgroundFetch] fix warnings about restoration id May 20, 2015
SimpleBackgroundTransfer Fix metadata file Sep 8, 2016
SimpleCollectionView Resolved warnings in SimpleCollectionView sample May 5, 2015
SimpleDrillDown Fix metadata file Sep 8, 2016
SimpleLogin Fix metadata file Sep 8, 2016
SimpleTextInput Mass update of MinimumOSVersion value in Info.plist Nov 13, 2015
SoZoomy Added some code improvement Oct 11, 2016
SocialFrameworkDemo Fix metadata file Sep 8, 2016
Sound [Sound] Fix #43584 + remove redundant s Aug 23, 2016
SplitView Mass update of MinimumOSVersion value in Info.plist Nov 13, 2015
SpriteKit [Entitlements] Remove custom entitlements from project's configuration Jul 29, 2015
SpriteKitPhysicsCollisions Add brief description tag to metadata.xml Mar 23, 2015
SpriteTour Fix metadata file Sep 8, 2016
StandardControls removed duplicate samples, add moveto.md Feb 12, 2013
Stars Mass update of MinimumOSVersion value in Info.plist Nov 13, 2015
StateRestoration Added description for accessibility keys Oct 19, 2016
StoreKit Mass update of MinimumOSVersion value in Info.plist Nov 13, 2015
StoryboardIntro [StoryboardInfo] Remove DS_Store from project file references, fix #3… Feb 18, 2016
StoryboardTable Fix metadata file Sep 8, 2016
StoryboardTable_LocalAuthentication Fix metadata file Sep 8, 2016
StreamingAudio [Entitlements] Remove custom entitlements from project's configuration Jul 29, 2015
SysSound Fix metadata file Sep 8, 2016
Tabbed_Images Fix metadata file Sep 8, 2016
TableAndCellStyles removed duplicate samples, add moveto.md Feb 12, 2013
TableEditing Mass update of MinimumOSVersion value in Info.plist Nov 13, 2015
TableParts Mass update of MinimumOSVersion value in Info.plist Nov 13, 2015
TextKitDemo Fix metadata file Sep 8, 2016
ThreadedCoreData [ThreadedCoreData] Disable app transport security Sep 10, 2015
TicTacToe Resolved warnings in TicTacToe sample May 5, 2015
Touch [touch] update screenshots, link to doc Oct 14, 2015
Touches_Classic Fix metadata file Sep 8, 2016
Touches_GestureRecognizers Mass update of MinimumOSVersion value in Info.plist Nov 13, 2015
Transitioning_To_Xcode_4 Fix metadata file Sep 8, 2016
TransitionsDemo Resolved warnings in TransitionsDemo sample May 5, 2015
UIImageEffects Update brief tags description Mar 27, 2015
ViewTransitions Add brief description tag to metadata.xml Mar 23, 2015
WalkingGameCompleteiOS Fix metadata file Sep 8, 2016
WalkingGameEmptyiOS Fix metadata file Sep 8, 2016
WatchKit [watchOS] remove old samples from gallery Sep 22, 2016
WayUpSample Fix metadata file Sep 8, 2016
WeatherMap Fix metadata file Sep 8, 2016
WebView Adding Webview sample Jul 15, 2016
WorkingWithImages Fix metadata file Sep 8, 2016
WorkingWithTables Fixing projects that did not run due to not having a Root ViewControl… Aug 13, 2016
Working_with_images Fix metadata file Sep 8, 2016
WorldCities [WorldCities] Fix table cell style, fix for #35688 Nov 13, 2015
ZoomingPdfViewer Fix metadata file Sep 8, 2016
iOS7-ui-updates [ImageView] Code refactoring May 26, 2016
intro-to-extensions Fix metadata file Sep 8, 2016
ios10 [avcam] update readme: for markdown parser on samples portal Oct 20, 2016
ios7fonts Fix metadata file Sep 8, 2016
ios8 Added missing key to MotionActivityDemo Oct 20, 2016
ios9 [quickcontacts] update meta to match directory iOS9 Oct 19, 2016
tvos Fix metadata file Sep 8, 2016
watchOS [ActivityRings] Remove custom HttpClient handlers Nov 10, 2016
.gitattributes Add sln file (and make sure it stays as CRLF because VS needs it) for… Sep 9, 2011
.gitignore Support for iOS 10 Sep 30, 2016
LICENSE Add License Sep 27, 2011
Make.common Fix MonoCatalogSample build and include basic instructions to use the… Apr 10, 2012
Makefile Add a convenient Makefile to build the samples Jan 16, 2016
README.md Update README.md Sep 8, 2016
Xamarin.Edu.SampleGallery.Core.dll Update sample validator. Jul 5, 2012
install-hook.sh Added CoreAnimation Sample + Chmod +x on git hook install Sep 30, 2011
mdtool-build Fix mdtool build invocation. Oct 4, 2011
pre-commit.posix Fix pre-commit script's use of ==. Feb 20, 2012
validate.posix Fix usage of `find` in some scripts. Feb 17, 2012
xcsv.exe Update sample validator. Jul 5, 2012

README.md

iOS/tvOS/watchOS Samples

The samples in this directory use the Xamarin.iOS toolchain and Xamarin Studio project files to illustrate the basics of how to work with iOS and the SDK.

License

The Apache License 2.0 applies to all samples in this repository.

Copyright 2011 Xamarin Inc

Licensed 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

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Samples Layout

Version Specific Samples

Starting with iOS 8, we started adding samples that showcase specific features introduced in a release into a directory for the release. So all the new iOS 8 feature samples live in the ios8 directory, the iOS 9 features live in the ios9 directory and the iOS 10 feature lives in the ios10 directory.

WatchKit

WatchKit samples are in the WatchKit directory, there are a couple of them:

Contributing

Before adding a sample to the repository, please run either install-hook.bat or install-hook.sh depending on whether you're on Windows or a Posix system. This will install a Git hook that runs the Xamarin code sample validator before a commit, to ensure that all samples are good to go.

Samples Submission Guidelines

Galleries

We love samples! Application samples show off our platform and provide a great way for people to learn our stuff. And we even promote them as a first-class feature of the docs site. You can find our two sample galleries here:

Sample GitHub Repositories

These sample galleries are populated by samples in our six sample GitHub repos:

The mobile-samples repository is for samples that are cross-platform. The mac-ios-samples repository is for samples that are Mac/iOS only.

Sample Requirements

We welcome sample submissions. Please ping Nat or Miguel for repo commit access.

However, because the sample galleries are powered by the github sample repos, each sample needs to have the following things:

  • Screenshots - a folder called Screenshots that has at least one screen shot of the sample (preferably a screen shot for every page or every major functionality piece, people really key off these things). for the xplat samples, the folder should be split into platform folders, e.g. iOS, Android, Windows. see https://github.com/xamarin/mobile-samples/tree/master/Tasky/Screenshots for an example of this.

  • Readme - a README.md file that has the name of the sample, a description, and author attribution. sample here: https://github.com/xamarin/mobile-samples/blob/master/Tasky/README.md

  • Metadata - Finally, it needs a Metadata.xml file (https://github.com/xamarin/mobile-samples/blob/master/Tasky/Metadata.xml) that has some information:

    • ID - A GUID for the sample. You can generate this in MD under Tools menu : Insert GUID. we need this to key between articles and their associated samples

    • IsFullApplication - Boolean flag (true or false): whether or not this is a full application such as the MWC App, Tasky, etc., or it's just a feature sample, such as, how to use 'x' feature. the basic test here is, if you would submit this to the app store because it's useful, then it's a full app, otherwise it's just a feature sample.

    • Brief - Short description or what your sample does. This allows us to display a nice and clean vignette on the sample page.

    • Level - Beginner, Intermediate, or Advanced: this is the intended audience level for the sample. only the getting started samples are Beginner, as they are intended for people who are just starting with the platform. most samples are Intermediate, and a few, that dive deep into difficult APIs, should be Advanced.

    • Minimum License Requirement - Starter, Indie, Business, or Enterprise: denotes the license that a user has to have in order to build/run the sample.

    • Tags: a list of relevant tags for the app. These are:

      • Data
      • User Interface
      • Games
      • Graphics (CoreDrawing, Animation, OpenGL...)
      • Media (Video, Sound, recording, photos)
      • Platform Features (Photo Library, Contacts, Calendars, etc.)
      • Device Features (NFC, Accelerometer, Compass, Magnemometer, Bluetooth, RFID)
      • Cloud (Web Services, Networking, etc.)
      • Backgrounding
      • Maps + Location
      • Binding + Interop (Projections)
      • Notifications
      • Touch
      • Getting Started
      • Async
      • Extension
      • iOS8
      • iOS9
      • iOS10
      • Watch
      • Keyboard
      • SceneKit
      • FSharp
    • SupportedPlatforms: this is only for cross plat samples. It's a comma-separated list, and the valid values are iOS, Android, and Windows.

    • Gallery: This tag must contain a value of true if you want the sample to show up in the samples gallery on the developer portal.

  • Buildable Sln and CSProj file - the project must build and have the appropriate project scaffolding (solution + proj).

A good example of this stuff is here in the drawing sample: https://github.com/xamarin/monotouch-samples/tree/master/Drawing

For a x-platform sample, please see: https://github.com/xamarin/mobile-samples/tree/master/Tasky

GitHub Integration

We integrate tightly with Git to make sure we always provide working samples to our customers. This is achieved through a pre-commit hook that runs before your commit goes through, as well as a post-receive hook on GitHub's end that notifies our samples gallery server when changes go through.

To you, as a sample committer, this means that before you push to the repos, you should run the "install-hook.bat" or "install-hook.sh" (depending on whether you're on Windows or OS X/Linux, respectively). These will install the Git pre-commit hook. Now, whenever you try to make a Git commit, all samples in the repo will be validated. If any sample fails to validate, the commit is aborted; otherwise, your commit goes through and you can go ahead and push.

This strict approach is put in place to ensure that the samples we present to our customers are always in a good state, and to ensure that all samples integrate correctly with the sample gallery (README.md, Metadata.xml, etc). Note that the master branch of each sample repo is what we present to our customers for our stable releases, so they must always Just Work.

Should you wish to invoke validation of samples manually, simply run "validate.windows" or "validate.posix" (again, Windows vs OS X/Linux, respectively). These must be run from a Bash shell (i.e. a terminal on OS X/Linux or the Git Bash terminal on Windows).

If you have any questions, don't hesitate to ask on Xamarin Forums!