Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Xamarin.iOS sample apps
Failed to load latest commit information.
AQTapDemo [AQTapDemo] fix metadata
AUSoundTriggeredPlayingSoundMemoryBased Pull from upstream
AVCaptureFrames Pull from upstream
AVCompositionDebugVieweriOS Pull from upstream
AVCustomEdit Update README.md
AVTouchSample Pull from upstream
AirLocate Pull from upstream
AppPrefs Pull from upstream
AsyncDownloadImage Pull from upstream
AudioConverterFileConverter [AudioConverterFileConverter] Don't complain about not getting any pa…
AudioGenerator Pull from upstream
AudioQueueOfflineRenderDemo Pull from upstream
AudioTapProcessor Pull from upstream
BackgroundExecution Pull from upstream
BindingSample Working With Images
BouncingGameCompleteiOS Fixed fonts using the "non" build action instead of BundleResource.
BouncingGameEmptyiOS Removed files that should not have been added to the project in the f…
BubbleCell Pull from upstream
ButtonEventDemo Pull from upstream
ButtonTapper3000 Pull from upstream
Calendars Pull from upstream
CircleLayout Pull from upstream
CollectionViewTransition Pull from upstream
ContentControls removed duplicate samples, add moveto.md
Controls Pull from upstream
CoreAnimation Pull from upstream
CoreImage Pull from upstream
CoreLocation Pull from upstream
CoreMidiSample Pull from upstream
CoreTelephonyDemo Pull from upstream
CustomCollectionViewLayoutAttributes Pull from upstream
CustomInputStream CustomInputStream: protect against stack overflows. Fixes #25376.
CustomPropertyAnimation Pull from upstream
Data Pull from upstream
DesignerWalkthrough Pull from upstream
Drawing Pull from upstream
DynamicsCatalog Pull from upstream
EvolveGraphicsAndAnimation Pull from upstream
FileSystemSampleCode Pull from upstream
FontList Pull from upstream
FrogScroller Pull from upstream
GLCameraRipple Pull from upstream
GLPaint-GameView Pull from upstream
GameCenterSample Pull from upstream
GoogleAdMobAds/binding Pull from upstream
HelloWorld_iPhone Pull from upstream
Hello_ComplexUniversal Pull from upstream
Hello_MultiScreen_iPhone Pull from upstream
Hello_Universal Pull from upstream
Hello_iPad Pull from upstream
HttpClient Pull from upstream
ImageProtocol Pull from upstream
KeyValueObserving Pull from upstream
Keychain Pull from upstream
LazyTableImages Pull from upstream
LazyTableImagesAsync Pull from upstream
LineLayout Pull from upstream
LowLevelGLPaint Pull from upstream
MTDJsonDemo Pull from upstream
MTDReflectionWalkthrough Pull from upstream
MTDWalkthrough Pull from upstream
MTGKTapper Pull from upstream
ManualStoryboard Pull from upstream
MapCallouts Pull from upstream
MapKitSearch Pull from upstream
MediaCapture Pull from upstream
MediaNotes Pull from upstream
MidiTest Pull from upstream
MonoCatalog-MonoDevelop Pull from upstream
MonoCatalogSample Pull from upstream
MonoDevelopTouchCells Pull from upstream
MotionGraphs Pull from upstream
MoviePlayback Pull from upstream
MultichannelMixer Pull from upstream
NSZombieApocalypse Pull from upstream
Notifications Pull from upstream
OpenGL Pull from upstream
OpenGLESSample-GameView Pull from upstream
OpenGLESSample Pull from upstream
OpenGLScroller Pull from upstream
PaintCode Pull from upstream
PassKit Update README.md
PinchIt Pull from upstream
PokerNightVoting Pull from upstream
Popovers Pull from upstream
PrintBanner Pull from upstream
PrintSample Pull from upstream
PrivacyPrompts Pull from upstream
Protocols_Delegates_Events Pull from upstream
QRchestra Pull from upstream
QuartzSample Pull from upstream
Quotes Pull from upstream
ReachabilitySample Pull from upstream
RecipesAndPrinting Pull from upstream
RegionDefiner Pull from upstream
RosyWriter Pull from upstream
Rotation Pull from upstream
SearchDemo Pull from upstream
SharedResources Pull from upstream
SimpleBackgroundFetch Pull from upstream
SimpleBackgroundTransfer Pull from upstream
SimpleCollectionView Pull from upstream
SimpleDrillDown Pull from upstream
SimpleTextInput Pull from upstream
SoZoomy Pull from upstream
SocialFrameworkDemo Pull from upstream
Sound Pull from upstream
SplitView Pull from upstream
SpriteKit Pull from upstream
SpriteKitPhysicsCollisions [SpriteKitPhysicsCollisions] fix readme
SpriteTour Pull from upstream
StandardControls removed duplicate samples, add moveto.md
Stars Pull from upstream
StateRestoration Pull from upstream
StoreKit Merge branch 'master' of https://github.com/xamarin/monotouch-samples
StoryboardTable Pull from upstream
StoryboardTable_LocalAuthentication Pull from upstream
StreamingAudio [StreamingAudio] change string value with enum
SysSound Pull from upstream
Tabbed_Images Pull from upstream
TableAndCellStyles removed duplicate samples, add moveto.md
TableEditing Pull from upstream
TableParts Pull from upstream
TextKitDemo Pull from upstream
ThreadedCoreData Pull from upstream
TicTacToe Pull from upstream
Touch Pull from upstream
Touches_Classic Pull from upstream
Touches_GestureRecognizers Pull from upstream
Transitioning_To_Xcode_4 Pull from upstream
TransitionsDemo Pull from upstream
UIImageEffects Pull from upstream
ViewTransitions Pull from upstream
WalkingGameCompleteiOS Added new pre-built MonoGame dll to address iOS 8 resolution bug in t…
WalkingGameEmptyiOS Fixed up a bad reference to monogame - used explicit reference instea…
WatchKit Updated README and metadata
WayUpSample Pull from upstream
WeatherMap Pull from upstream
WorkingWithImages Working With Images
Working_with_images Pull from upstream
WorldCities Pull from upstream
ZoomingPdfViewer Pull from upstream
ios7fonts Pull from upstream
ios8 Updated README and metadata
.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.