Skip to content

seopower/monodroid-samples

This branch is 1 commit ahead of, 662 commits behind dotnet/android-samples:main.

Folders and files

NameName
Last commit message
Last commit date
Jun 20, 2014
Jun 27, 2014
Jul 15, 2014
Aug 21, 2014
Sep 29, 2014
Apr 16, 2014
Feb 20, 2014
Feb 20, 2014
Feb 25, 2014
Jun 21, 2013
Feb 20, 2014
Jan 9, 2014
Nov 5, 2014
Aug 7, 2013
Feb 20, 2014
Feb 27, 2014
Aug 15, 2013
Jul 14, 2014
Jul 14, 2014
Jul 22, 2014
Feb 20, 2014
Feb 25, 2014
Feb 20, 2014
Jan 11, 2015
Jan 11, 2015
Aug 20, 2014
Feb 20, 2014
Feb 20, 2014
Jan 23, 2014
Aug 18, 2014
Nov 19, 2014
Feb 25, 2014
Feb 20, 2014
Aug 6, 2013
Feb 20, 2014
Feb 12, 2013
Feb 20, 2014
Jul 15, 2014
Feb 17, 2014
Jul 14, 2014
Aug 18, 2014
Aug 9, 2013
Jun 20, 2014
Feb 20, 2014
Feb 20, 2014
Jun 25, 2014
Jul 14, 2014
Jul 7, 2014
Nov 17, 2014
Jul 30, 2014
Aug 1, 2014
Feb 20, 2014
Jul 17, 2014
Jul 17, 2014
Feb 20, 2014
Feb 20, 2014
Feb 20, 2014
Jan 8, 2013
Jul 1, 2014
Jul 22, 2014
Jul 17, 2014
Jul 17, 2014
Jul 17, 2014
Aug 4, 2014
Nov 25, 2013
Nov 25, 2014
Jan 8, 2014
Apr 22, 2014
Jun 20, 2014
Feb 20, 2014
Apr 22, 2014
Feb 20, 2014
Feb 20, 2014
Aug 1, 2014
Jun 30, 2014
Feb 20, 2014
Jun 30, 2014
Jul 31, 2014
Apr 22, 2014
Jul 22, 2014
Feb 20, 2014
Dec 17, 2014
Jul 24, 2013
Apr 9, 2014
Jun 20, 2014
Feb 20, 2014
Mar 20, 2014
Apr 24, 2014
Feb 20, 2014
Feb 9, 2015
Feb 1, 2015
Feb 9, 2015
Sep 29, 2014
May 1, 2014
Sep 19, 2013
Jun 21, 2013
Feb 20, 2014
Jan 8, 2013
Jul 4, 2014
Dec 15, 2014
Feb 20, 2014
Sep 5, 2014
Feb 20, 2014
Dec 14, 2014
Feb 20, 2014
Jul 14, 2014
Jun 20, 2014
Feb 20, 2014
Feb 25, 2015
Jul 14, 2014
Feb 20, 2014
Feb 20, 2014
May 1, 2014
Mar 4, 2014
Apr 4, 2013
Feb 12, 2013
Feb 25, 2014
Feb 25, 2014
Nov 5, 2014
Jan 23, 2015
May 1, 2014
Apr 10, 2014
Apr 22, 2014
Aug 11, 2014
Feb 12, 2013
Jun 26, 2014
Jul 17, 2014
Jan 13, 2015
Mar 12, 2014
Jun 11, 2014
Feb 20, 2014
May 1, 2014
Nov 9, 2014
Nov 9, 2014
Dec 12, 2014
Apr 2, 2015
Feb 24, 2015
Nov 11, 2014
Nov 25, 2014
Oct 13, 2014
Feb 20, 2014
Jul 5, 2012
Mar 11, 2013
Sep 21, 2011
Sep 27, 2011
May 22, 2012
May 22, 2012
Aug 16, 2010
May 22, 2012
Feb 17, 2012
Feb 24, 2011
Jul 5, 2012

Repository files navigation

MonoDroid Samples

This repository contains Mono for Android samples, showing usage of various Android API wrappers from C#.

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.

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 Contribution 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 three sample GitHub repos:

The mobile-samples repository is for samples that are cross-platform.

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.

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

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

About

A collection of Xamarin.Android sample projects.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • C# 66.8%
  • Java 32.7%
  • HTML 0.2%
  • Shell 0.1%
  • GLSL 0.1%
  • Ruby 0.1%