Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Xamarin.iOS sample apps
C# Objective-C Mercury F# HTML Shell Other
Failed to load latest commit information.
AQTapDemo no message
AUSoundTriggeredPlayingSoundMemoryBased [AUSoundTriggeredPlayingSoundMemoryBased] fix sdk warning
AVCaptureFrames no message
AVCompositionDebugVieweriOS no message
AVCustomEdit no message
AVTouchSample [Keychain][monocatalog][ExtensionsDemo][Touch][avTouch][reachability]…
AirLocate no message
AppPrefs no message
AsyncDownloadImage no message
AudioConverterFileConverter Add brief description tag to metadata.xml
AudioGenerator [AudioGenerator] Add minimum OS version
AudioQueueOfflineRenderDemo Add brief description tag to metadata.xml
AudioTapProcessor [AudioTapProcessor] fix warnings
BackgroundExecution Add brief description tag to metadata.xml
BindingSample [Xamarin.XMBindingLibrarySample] remove unused member
BouncingGameCompleteiOS no message
BouncingGameEmptyiOS no message
BubbleCell [BubbleCell] deprecate sample
ButtonEventDemo [ButtonEventDemo] Add minimum OS version
ButtonTapper3000 [ButtonTapper3000] resolve warnings
Calendars no message
Chat Update README.md
CircleLayout no message
CollectionViewTransition no message
ContentControls removed duplicate samples, add moveto.md
Controls no message
CoreAnimation Add brief description tag to metadata.xml
CoreImage no message
CoreLocation [Keychain][monocatalog][ExtensionsDemo][Touch][avTouch][reachability]…
CoreMidiSample Resolving and clearing out warning messages
CoreTelephonyDemo Further resolved warnings and errors in monotouch-samples
CreatingTabbedApplications Adding Creating Tabbed Application sample
CustomCollectionViewLayoutAttributes Further resolved warnings and errors in monotouch-samples
CustomInputStream Add brief description tag to metadata.xml
CustomPropertyAnimation Further resolved warnings and errors in monotouch-samples
Data Add brief description tag to metadata.xml
DesignerWalkthrough remove designer walkthrough sample
DispatchSourceExamples [DispatchSourceExamples] Code improvements:
Drawing Further resolved warnings and errors in monotouch-samples
DynamicsCatalog Further resolved warnings and errors in monotouch-samples
EvolveGraphicsAndAnimation [EvolveGraphicsAndAnimation] Add minimum OS version
FileSystemSampleCode Further resolved warnings and errors in monotouch-samples
FontList [Keychain][monocatalog][ExtensionsDemo][Touch][avTouch][reachability]…
FrogScroller Update brief tags description
GLCameraRipple [GLCameraRipple] Update code signing key
GLPaint-GameView Further resolved warnings and errors in monotouch-samples
GameCenterSample Further resolved warnings and errors in monotouch-samples
GoogleAdMobAds/binding Pull from upstream
GraphicsAndAnimation [AnimationSamples] prettify code. remove redundant newlines. use init…
HelloWorld_iPhone Add brief description tag to metadata.xml
Hello_ComplexUniversal Update brief tags description
Hello_MultiScreen_iPhone Add brief description tag to metadata.xml
Hello_Universal Update brief tags description
Hello_iOS Revert "Add Calabash.Start even if it already exists"
Hello_iPad Add brief description tag to metadata.xml
HomeKit/HomeKitIntro HomeKitIntro
HttpClient Further resolved warnings and errors in monotouch-samples
ImageProtocol Add brief description tag to metadata.xml
InfColorPicker HomeKitIntro
KeyValueObserving [KeyValueObserving] Observe View's layer changes, bug #29339
Keychain [Keychain][monocatalog][ExtensionsDemo][Touch][avTouch][reachability]…
LazyTableImages [LazyTableImages] Fix crash on startup
LazyTableImagesAsync Further resolved warnings and errors in monotouch-samples
LineLayout Further resolved warnings and errors in monotouch-samples
LowLevelGLPaint Further resolved warnings and errors in monotouch-samples
MTDJsonDemo [MTDJsonDemo] fix warning about supported orientations
MTDReflectionWalkthrough Add brief description tag to metadata.xml
MTDWalkthrough Further resolved warnings and errors in monotouch-samples
MTGKTapper Add minimum OS version
ManualStoryboard Adding conditional segue sample for docs purposes
MapCallouts Add brief description tag to metadata.xml
MapKitSearch Further resolved warnings and errors in monotouch-samples
MediaCapture Further resolved warnings and errors in monotouch-samples
MediaNotes Further resolved warnings and errors in monotouch-samples
MidiTest Further resolved warnings and errors in monotouch-samples
MonoCatalog-MonoDevelop [Keychain][monocatalog][ExtensionsDemo][Touch][avTouch][reachability]…
MonoCatalogSample Pull from upstream
MonoDevelopTouchCells Adjust FinishedLaunching() structure
MotionGraphs Further resolved warnings and errors in monotouch-samples
MoviePlayback Further resolved warnings and errors in monotouch-samples
MultichannelMixer Further resolved warnings and errors in monotouch-samples
NSZombieApocalypse Shorten brief descriptions
Notifications Further resolved warnings and errors in monotouch-samples
OpenGL [OpenGL] Update GLKBaseEffectDrawing sample
OpenGLESSample-GameView Shorten brief descriptions
OpenGLESSample Adjust FinishedLaunching() structure
OpenGLScroller Add brief description tag to metadata.xml
PaintCode Further resolved warnings and errors in monotouch-samples
PassKit Add brief description tag to metadata.xml
PinchIt Further resolved warnings and errors in monotouch-samples
PokerNightVoting Add brief description tag to metadata.xml
Popovers Add brief description tag to metadata.xml
PrintBanner Add brief description tag to metadata.xml
PrintSample Add brief description tag to metadata.xml
PrivacyPrompts [PrivacyPrompts_Classic] clean usings
Protocols_Delegates_Events Add brief description tag to metadata.xml
QRchestra Resolved warnings in QRchestra sample
QuartzSample Resolved warnings in QuartzSample sample
Quotes Resolved warnings in Quotes sample
ReachabilitySample [Keychain][monocatalog][ExtensionsDemo][Touch][avTouch][reachability]…
RecipesAndPrinting [RecipesAndPrinting] Add minimum OS version
RegionDefiner Resolved warnings in RegionDefiner sample
RosyWriter Resolved warnings in RosyWriter sample
Rotation [Rotation] Add bundle identifier
ScratchTicket Removed Xamarin Test Cloud Agent component from ScratchTicket to redu…
SearchDemo [SearchDemp] Add minimum OS version
SharedResources Resolved warnings in SharedResources sample
SimpleBackgroundFetch [SimpleBackgroundFetch] fix warnings about restoration id
SimpleBackgroundTransfer Add brief description tag to metadata.xml
SimpleCollectionView Resolved warnings in SimpleCollectionView sample
SimpleDrillDown Shorten brief descriptions
SimpleTextInput Resolved warnings in SimpleTextInput sample
SoZoomy Add brief description tag to metadata.xml
SocialFrameworkDemo Add brief description tag to metadata.xml
Sound Shorten brief descriptions
SplitView Add brief description tag to metadata.xml
SpriteKit Resolved warnings in SpriteKit sample
SpriteKitPhysicsCollisions Add brief description tag to metadata.xml
SpriteTour Shorten brief descriptions
StandardControls removed duplicate samples, add moveto.md
Stars Add brief description tag to metadata.xml
StateRestoration Shorten brief descriptions
StoreKit Add brief description tag to metadata.xml
StoryboardTable Resolved warnings in StoryboardTable sample
StoryboardTable_LocalAuthentication Resolved warnings in StoryboardTable_LocalAuthentication sample
StreamingAudio Add brief description tag to metadata.xml
SysSound Merge branch 'master' of github.com:xamarin/monotouch-samples
Tabbed_Images Add brief description tag to metadata.xml
TableAndCellStyles removed duplicate samples, add moveto.md
TableEditing Add brief description tag to metadata.xml
TableParts Resolved warnings in TableParts sample
TextKitDemo Resolved warnings in TextKitDemo sample
ThreadedCoreData Add brief description tag to metadata.xml
TicTacToe Resolved warnings in TicTacToe sample
Touch [Keychain][monocatalog][ExtensionsDemo][Touch][avTouch][reachability]…
Touches_Classic Add brief description tag to metadata.xml
Touches_GestureRecognizers [Touches_GestureRecognizers] resolve warnings
Transitioning_To_Xcode_4 Add brief description tag to metadata.xml
TransitionsDemo Resolved warnings in TransitionsDemo sample
UIImageEffects Update brief tags description
ViewTransitions Add brief description tag to metadata.xml
WalkingGameCompleteiOS Fixed WalkingGameComplete to use MonoGame 3.3 and support 64 bit.
WalkingGameEmptyiOS Resolved warnings in WalkingGameEmptyBasic sample
WatchKit [WatchNotifications] Fix Project Reference relative path
WayUpSample Shorten brief descriptions
WeatherMap Add brief description tag to metadata.xml
WorkingWithImages Working with Images
Working_with_images [Working_with_images] Add minimum OS version
WorldCities Resolved warnings in WorldCities sample
ZoomingPdfViewer Resolved warnings in ZoomingPdfViewer sample
ios7fonts Add brief description tag to metadata.xml
ios8 [Dynamic Launch Screens]Tidying metadata tags
.gitattributes Add sln file (and make sure it stays as CRLF because VS needs it) for…
.gitignore [gitignore] Removed packages folder
LICENSE Add License
Make.common Fix MonoCatalogSample build and include basic instructions to use the…
README.md Updated README file
Xamarin.Edu.SampleGallery.Core.dll Update sample validator.
install-hook.sh Added CoreAnimation Sample + Chmod +x on git hook install
mdtool-build Fix mdtool build invocation.
pre-commit.posix Fix pre-commit script's use of ==.
validate.posix Fix usage of `find` in some scripts.
xcsv.exe Update sample validator.

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

iOS 8 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.

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
      • 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
      • 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!

Something went wrong with that request. Please try again.