Xamarin.iOS sample apps
C# Objective-C Makefile GLSL F# HTML Other
Latest commit aa0ebd3 Jul 22, 2016 @olegoid olegoid committed on GitHub Merge pull request #98 from xamarin/ice-cream-builder
[IceCreamBuilder] Add new sample
Failed to load latest commit information.
AQTapDemo no message Apr 27, 2015
AUSoundTriggeredPlayingSoundMemoryBased [AUSoundTriggeredPlayingSoundMemoryBased] Setup root view controller … Sep 11, 2015
AVCam [AVCam] add metadata Jun 30, 2016
AVCaptureFrames [AVCaptureFrames] Use CVOptionFlags in CVPixelBuffer.Lock: Mar 20, 2016
AVCompositionDebugVieweriOS no message Apr 27, 2015
AVCustomEdit [AVCustomEdit] fix nre and make syntax analyzer happy Oct 23, 2015
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 18, 2016
BackgroundExecution Mass update of MinimumOSVersion value in Info.plist Nov 13, 2015
BindingSample Mono touch Samples - Readme Formatting Jun 4, 2015
BouncingGameCompleteiOS [BouncingGame] update packages Oct 6, 2015
BouncingGameEmptyiOS [Entitlements] Remove custom entitlements from project's configuration Jul 29, 2015
BubbleCell [BubbleCell] deprecate sample May 6, 2015
ButtonEventDemo [ButtonEventDemo] Add minimum OS version Apr 29, 2015
ButtonTapper3000 [ButtonTapper3000] resolve warnings May 19, 2015
Calendars no message Apr 27, 2015
Chat [Entitlements] Remove custom entitlements from project's configuration Jul 29, 2015
CircleLayout no message Apr 27, 2015
CollectionViewTransition no message Apr 27, 2015
ContentControls removed duplicate samples, add moveto.md Feb 12, 2013
Controls [Entitlements] Remove custom entitlements from project's configuration Jul 29, 2015
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 Mass update of MinimumOSVersion value in Info.plist Nov 13, 2015
CreatingTabbedApplications [Entitlements] Remove custom entitlements from project's configuration Jul 29, 2015
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 Mass update of MinimumOSVersion value in Info.plist Nov 13, 2015
DesignerWalkthrough [Entitlements] Remove custom entitlements from project's configuration Jul 29, 2015
DispatchSourceExamples [DispatchSourceExamples] Dispose file stream in vnode test Jun 20, 2016
Drawing Mass update of MinimumOSVersion value in Info.plist Nov 13, 2015
DynamicsCatalog [Entitlements] Remove custom entitlements from project's configuration Jul 29, 2015
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 Mass update of MinimumOSVersion value in Info.plist Nov 13, 2015
FrogScroller [FrogScroller] Add bundle identifier and app name Jun 17, 2015
GLCameraRipple [GLCameraRipple] Fix #34018: use GLKViewDelegate method instead of event Sep 16, 2015
GLPaint-GameView Mass update of MinimumOSVersion value in Info.plist Nov 13, 2015
GameCenterSample Add a convenient Makefile to build the samples Jan 15, 2016
GoogleAdMobAds/binding Pull from upstream Jan 19, 2015
GraphicsAndAnimation [CoreGraphicsSamples] Fix architecture in Debug|iPhoneSimulator config: Mar 22, 2016
GrowRowTable Add a convenient Makefile to build the samples Jan 16, 2016
HelloComponents Update HelloComponents sample with AlertCenter component May 25, 2016
HelloWorld_iPhone Add brief description tag to metadata.xml Mar 23, 2015
Hello_ComplexUniversal Mass update of MinimumOSVersion value in Info.plist Nov 13, 2015
Hello_MultiScreen_iPhone Mass update of MinimumOSVersion value in Info.plist Nov 13, 2015
Hello_Universal Mass update of MinimumOSVersion value in Info.plist Nov 13, 2015
Hello_iOS [hello, ios] renaming class. Apr 12, 2016
Hello_iPad Mass update of MinimumOSVersion value in Info.plist Nov 13, 2015
HomeKit/HomeKitIntro iOS 8: Handoff App Sep 2, 2015
HttpClient [HttpClient] Fix for #39991: Mar 30, 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 [IntoToAppearance]Adding new sample for docs purposes Jun 25, 2015
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 Mass update of MinimumOSVersion value in Info.plist Nov 13, 2015
LazyTableImages [LazyTableImages] Fix crash on startup May 12, 2015
LazyTableImagesAsync [imagesasync] fixes #56 Jun 11, 2015
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 10, 2015
LowLevelGLPaint LowLevelGLPaint fix for Bug37416 Jun 16, 2016
MTDJsonDemo [MTDJsonDemo] fix warning about supported orientations May 20, 2015
MTDReflectionWalkthrough Add brief description tag to metadata.xml Mar 23, 2015
MTDWalkthrough Further resolved warnings and errors in monotouch-samples Apr 28, 2015
MTGKTapper [MTGKTapper] fix method names. remove system version check because we… Aug 13, 2015
ManualCameraControls [ManualCameraControls] Use CVOptionFlags in CVPixelBuffer.Lock: Mar 20, 2016
ManualStoryboard [Entitlements] Remove custom entitlements from project's configuration Jul 29, 2015
MapCallouts [MapCallouts] Fix Info.plist #41275 May 24, 2016
MapDemo [MapDemo]Formatting fixes re. feedback from Oleg Jan 18, 2016
MapKitSearch Further resolved warnings and errors in monotouch-samples Apr 28, 2015
MediaNotes Mass update of MinimumOSVersion value in Info.plist Nov 13, 2015
MidiTest [Entitlements] Remove custom entitlements from project's configuration Jul 29, 2015
MonoCatalog-MonoDevelop Mass update of MinimumOSVersion value in Info.plist Nov 13, 2015
MonoCatalogSample Pull from upstream Jan 19, 2015
MonoDevelopTouchCells Mass update of MinimumOSVersion value in Info.plist Nov 13, 2015
MotionGraphs [MotionGraphs] Fix UIView ctor to be called from nib Jun 15, 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 Mass update of MinimumOSVersion value in Info.plist Nov 13, 2015
OpenGLESSample Mass update of MinimumOSVersion value in Info.plist Nov 13, 2015
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 18, 2016
PrintBanner Add brief description tag to metadata.xml Mar 23, 2015
PrintSample Mass update of MinimumOSVersion value in Info.plist Nov 13, 2015
PrivacyPrompts [PrivacyPromts] Update entitlements Jul 29, 2015
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] update readme with additional sample qrcode Feb 22, 2016
QuartzSample Mass update of MinimumOSVersion value in Info.plist Nov 13, 2015
Quotes Resolved warnings in Quotes sample May 5, 2015
ReachabilitySample Mass update of MinimumOSVersion value in Info.plist Nov 13, 2015
RecipesAndPrinting [RecipesAndPrinting] UIMarkupTextPrintFormatter is uikit class, so ct… Sep 17, 2015
RegionDefiner Resolved warnings in RegionDefiner sample May 5, 2015
RosyWriter Resolved warnings in RosyWriter sample May 5, 2015
Rotation Mass update of MinimumOSVersion value in Info.plist Nov 13, 2015
ScratchTicket [Entitlements] Remove custom entitlements from project's configuration Jul 29, 2015
SearchDemo [SearchDemp] Add minimum OS version Apr 28, 2015
SharedResources Mass update of MinimumOSVersion value in Info.plist Nov 13, 2015
SimpleBackgroundFetch [SimpleBackgroundFetch] fix warnings about restoration id May 20, 2015
SimpleBackgroundTransfer [SimpleBackgroundTransfer] Fix #71(#37341 in bugzilla) + code formatt… Jan 18, 2016
SimpleCollectionView Resolved warnings in SimpleCollectionView sample May 5, 2015
SimpleDrillDown Mass update of MinimumOSVersion value in Info.plist Nov 13, 2015
SimpleLogin [Entitlements] Remove custom entitlements from project's configuration Jul 29, 2015
SimpleTextInput Mass update of MinimumOSVersion value in Info.plist Nov 13, 2015
SoZoomy Add brief description tag to metadata.xml Mar 23, 2015
SocialFrameworkDemo Social Framework Demo Jun 9, 2016
Sound [sound] update screenshots for iOS 8 Jun 4, 2015
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 Shorten brief descriptions Apr 23, 2015
StandardControls removed duplicate samples, add moveto.md Feb 12, 2013
Stars Mass update of MinimumOSVersion value in Info.plist Nov 13, 2015
StateRestoration [StateRestoration] Add license Feb 18, 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-38099] Removed underscore(_) from method names Jun 21, 2016
StoryboardTable_LocalAuthentication [StoryboardTable_LocalAuthentication] fix target Jun 19, 2015
StreamingAudio [Entitlements] Remove custom entitlements from project's configuration Jul 29, 2015
SysSound [Entitlements] Remove custom entitlements from project's configuration Jul 29, 2015
Tabbed_Images Mass update of MinimumOSVersion value in Info.plist Nov 13, 2015
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 [TextKitDemo] Fix ctor, we must use initWithCoder when loading from a… Jun 16, 2015
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 Mass update of MinimumOSVersion value in Info.plist Nov 13, 2015
Touches_GestureRecognizers Mass update of MinimumOSVersion value in Info.plist Nov 13, 2015
Transitioning_To_Xcode_4 Mass update of MinimumOSVersion value in Info.plist Nov 13, 2015
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 Update monogame framework to 3.5 to fix bug 37347 May 25, 2016
WalkingGameEmptyiOS Update monogame framework to 3.5 to fix bug 37347 May 25, 2016
WatchKit [WatchKitCatalog] Add license Feb 18, 2016
WayUpSample Mass update of MinimumOSVersion value in Info.plist Nov 13, 2015
WeatherMap Mass update of MinimumOSVersion value in Info.plist Nov 13, 2015
WebView Adding Webview sample Jul 14, 2016
WorkingWithImages [Entitlements] Remove custom entitlements from project's configuration Jul 29, 2015
WorkingWithTables Mass update of MinimumOSVersion value in Info.plist Nov 13, 2015
Working_with_images [Working_with_images] Add minimum OS version Apr 29, 2015
WorldCities [WorldCities] Fix table cell style, fix for #35688 Nov 13, 2015
ZoomingPdfViewer [ZoomingPdfViewer] only portait orientation should be allowed for thi… Jun 20, 2016
iOS7-ui-updates [ImageView] Code refactoring May 25, 2016
intro-to-extensions [Entitlements] Remove custom entitlements from project's configuration Jul 29, 2015
ios10/IceCreamBuilder [IceCreamBuilder] Code refactoring Jul 22, 2016
ios7fonts [Entitlements] Remove custom entitlements from project's configuration Jul 29, 2015
ios8 [VideoTimeLine] Fix formatting issues + floating comparison Jun 30, 2016
ios9 [FilterDemoApp] Update sample code: May 24, 2016
tvos Social Framework Demo Jun 9, 2016
watchOS [WatchKitCatalog] Remove warnings May 20, 2016
.gitattributes Add sln file (and make sure it stays as CRLF because VS needs it) for… Sep 9, 2011
.gitignore Update .gitignore Jul 18, 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 Add a convenient Makefile to build the samples Jan 16, 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

MonoTouch Samples

The samples in this directory use the MonoTouch toolchain and MonoDevelop 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, and the iOS 9 features live in the ios9 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 - Beginning, Intermediate, or Advanced: this is the intended audience level for the sample. only the getting started samples are Beginning, 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
      • 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!