Sample programs showing how to use Xamarin.Mac on OSX.
C# C GLSL HTML Makefile Objective-C Other
Latest commit 276b12d Jul 18, 2016 @olegoid olegoid committed on GitHub Update .gitignore
Failed to load latest commit information.
AnimatedClock [AnimatedClock] fix warning about font's name Jun 22, 2015
AnimatingViews Add brief description tag to metadata.xml Apr 16, 2015
AzureTodoMac [AzureTodoMac] Setup release configuration Mar 23, 2016
ButtonMadness Add brief description tag to metadata.xml Apr 16, 2015
CAQuartzComposition Shorten brief descriptions Apr 23, 2015
CFNetwork [CFNetwork] Add Mono.Addins nugget package to AsynTests.HttpClientTes… Oct 16, 2015
CoreAnimationBook Add brief description tag to metadata.xml Apr 16, 2015
CoreTextArcMonoMac [CoreTextArcMonoMac] Update license Feb 22, 2016
CoreWLANWirelessManager Add brief description tag to metadata.xml Apr 16, 2015
CustomFont Use a Google Font instead Feb 18, 2016
DatePicker Add brief description tag to metadata.xml Apr 16, 2015
DockAppIcon Add brief description tag to metadata.xml Apr 16, 2015
DocumentSample Add brief description tag to metadata.xml Apr 16, 2015
DragAndDropExample [DragAndDropExample] Update metadata + fix static analyzer issues Oct 30, 2015
DrawerMadness Add brief description tag to metadata.xml Apr 16, 2015
FSEvents Add brief description tag to metadata.xml Apr 16, 2015
Fire Add brief description tag to metadata.xml Apr 16, 2015
GLFullScreen [GLFullScreen] Update license Feb 22, 2016
GLSLShader Add brief description tag to metadata.xml Apr 16, 2015
GlossyClock [GlossyClock] fix warnings about font's name Jun 22, 2015
HeartRateMonitor Shorten brief descriptions Apr 23, 2015
Hello_Mac MacWindows Apr 19, 2016
HttpClient [HttpClient] Fix web-site url #41152 May 20, 2016
ImageKitDemoStep1 Shorten brief descriptions Apr 23, 2015
MacControls MacControls Dec 9, 2015
MacCopyPaste MacCopyPaste Dec 15, 2015
MacCustomControl MacCustomControl Feb 12, 2016
MacDatabase MacDatabase: Added ComboBox Info Apr 13, 2016
MacDatabinding-Storyboard MacDatabinding Dec 16, 2015
MacDatabinding-XIBs MacDatabinding Dec 16, 2015
MacDialog MacDialog Dec 8, 2015
MacImages MacCustomControl Feb 12, 2016
MacInspector MacInspector Mar 1, 2016
MacMenus MacMenus Feb 19, 2016
MacOpenTK [MacOpenTK] Update metadata + fix static analyzer issues: Oct 29, 2015
MacOutlines MacOutlines Dec 10, 2015
MacSourceLists MacSourceLists Dec 10, 2015
MacTables MacTables Apr 4, 2016
MacToolbar MacWindows Apr 19, 2016
MacWindows MacWindows Apr 19, 2016
MacXibless MacXibless Apr 30, 2015
MarkdownViewer Add brief description tag to metadata.xml Apr 16, 2015
MicroSamples Updated all Mac Samples README files Aug 18, 2014
MonoMacGameWindow Add brief description tag to metadata.xml Apr 16, 2015
MouseTrackingExample [MouseTrackingExample] Update metadata: Oct 29, 2015
NSAlert Add brief description tag to metadata.xml Apr 16, 2015
NSComboBoxTest Shorten brief descriptions Apr 23, 2015
NSCustomView Mac Samples Jun 4, 2015
NSImageName Add brief description tag to metadata.xml Apr 16, 2015
NSOutlineViewAndTableView Mac Samples Jun 4, 2015
NSPortExample [NSPortExample] Fix minor formatting issues Jun 21, 2016
NSTableViewBinding [NSTableViewBinding] Update license Feb 22, 2016
NSTextViewSample Shorten brief descriptions Apr 23, 2015
OpenGL-NeHe [OpenGL-NeHe/NeHeLesson13] Update sample to use 2.0 API, fix #29268 Apr 21, 2015
OpenGLLayer Add brief description tag to metadata.xml Apr 16, 2015
OpenGLViewSample Add brief description tag to metadata.xml Apr 16, 2015
OutlineView Shorten brief descriptions Apr 23, 2015
PopupBindings [PopupBindings] Add license Feb 22, 2016
PredicateEditorSample [PredicateEditorSample] Update license Feb 22, 2016
ProgressBarExample [ProgressBarExample] Update metadata + fix static analyzer issues Oct 30, 2015
QTRecorder Add brief description tag to metadata.xml Apr 16, 2015
ReactiveUIExample ReactiveUIExample May 20, 2015
RoundedTransparentWindow Add brief description tag to metadata.xml Apr 16, 2015
Rulers Add brief description tag to metadata.xml Apr 16, 2015
SCNetworkReachability Add brief description tag to metadata.xml Apr 16, 2015
SceneKitViewer [SceneKitViewer] Update license title Feb 22, 2016
SearchField [SearchField] Add license Feb 22, 2016
SkinnableApp Add brief description tag to metadata.xml Apr 16, 2015
SourceWriter MacTables Updated for Delete Apr 4, 2016
StillMotion Shorten brief descriptions Apr 23, 2015
UseMSBuildToCopyFilesToBundleExample [UseMSBuildToCopyFilesToBundleExample] Remove signing keys from Debug Mar 23, 2016
UserNotificationExample Add brief description tag to metadata.xml Apr 16, 2015
VillainTracker Add brief description tag to metadata.xml Apr 16, 2015
WhereIsMyMac [WhereIsMyMac] Update sample to use updated version of CoreLocation A… May 26, 2015
XMBindingExample XMBindingExample Jun 4, 2015
guiunit-example GUIUnit Feb 16, 2016
yosemite [Scene Kit Session WWDC 2013] Set CreatePackage to false Mar 24, 2016
.gitignore Update .gitignore Jul 18, 2016
AUTHORS AUTHORS: add myself Feb 21, 2013
Makefile bxc#10532: TwoMinuteGrowler: remove Feb 25, 2013
README.md [Readme] Add add two new tags - `Yosemite` and `El Capitan` Aug 20, 2015
config.mk Makefile: clean up Makefile Feb 21, 2013
list-tags list-tags, make-sample-metadata: helper tools Feb 20, 2013
make-sample-metadata list-tags, make-sample-metadata: helper tools Feb 20, 2013
migrate-to-xammac migrate-to-xammac: convert 'MonoMac, ...' references Feb 25, 2013

README.md

Mac Samples

Sample code for Xamarin's C# APIs to develop Mac applications.

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 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
      • SceneKit
      • FSharp
      • Yosemite
      • El Capitan
    • 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!