89071bc19d
* [Vision] Add bindings for Xcode 9 Beta 1 & 2 This commit also adds two convenience overloads to GetAttachments that allows you to get a more strongly typed version of the returned dictionary, this is needed because there is no easy way to downcast from NSDictionary to NSDictionary<TKey, TValue> and it is used in the sample that excecises the Vision API found here https://github.com/dalexsoto/FaceDetector * [Vision] Implement feedback * Add commas to enums to avoid diff spam * Throw a managed exception when we fail to dinamically call Vision framework * [Vision] Update to xcode 9 Beta 3 * [vision] fix VNImageCropAndScaleOption enum Also removed public modifier from enums in order to have interfaces and enums in sync * [Vision] Add missing comma to enum * [Vision] More API enhancements * Removed default .ctor from types that are not user created * Added Strong Dictionary to VNImageRequestHandler ctors * Turned VNImageOption into a StrongDictionary * Added bug report[1] for BarcodeDescriptor so we do not forget * Removed duped metadata from manual bindings * VNDetectedObjectObservation subclasses now have the factory method FromBoundingBox inherited from its parent class (VNDetectedObjectObservation). [1]: https://bugzilla.xamarin.com/show_bug.cgi?id=58197 * [Vision] Merge extern API with wrappers, fixed intro! * [Vision] Add one missing public accessor to VNUtils |
||
---|---|---|
builds | ||
docs | ||
external | ||
fsharp | ||
jenkins | ||
mk | ||
mono/4.5 | ||
msbuild | ||
opentk | ||
runtime | ||
src | ||
tests | ||
tools | ||
.gitignore | ||
.gitmodules | ||
LICENSE | ||
Make.config | ||
Makefile | ||
NuGet.config | ||
README.md | ||
Versions-ios.plist.in | ||
Versions-mac.plist.in | ||
Xamarin.Mac.sln | ||
Xamarin.iOS.sln | ||
banner.png | ||
configure | ||
product.snk | ||
system-dependencies.sh | ||
versions-check.csharp |
README.md
Xamarin.iOS & Xamarin.Mac
Status | |
---|---|
master |
Welcome!
This module is the main repository for both Xamarin.iOS and Xamarin.Mac.
These frameworks allow us to create native iOS, tvOS, watchOS and Mac applications using the same UI controls we would in Objective-C and Xcode, except with the flexibility and elegance of a modern language (C#), the power of the .NET Base Class Library (BCL), and two first-class IDEs—Xamarin Studio and Visual Studio—at our fingertips.
Continuous Builds
You can download continuous builds of our main development branches from our wiki page.
Build requirements
-
Autoconf, automake and libtool.
You can use brew, or this script to get it directly from gnu.org (you'll have to edit your PATH to include /opt/bin if you use the script)
To install brew and all the tool dependencies:
$ ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)" $ brew update $ brew install libtool autoconf automake bison flex
-
CMake
You can use brew, or download manually from cmake.org.
CMake must be in PATH, so if you install it somewhere else, you'll have to fix up your PATH accordingly (not necessary if installed using brew).
To install using brew:
$ brew install cmake
-
Xcode
To build the Xamarin.iOS and Xamarin.Mac SDKs you need a certain version of Xcode. The build will tell you exactly which version you need.
You can download the Xcode version you need from Apple's Developer Center (requires an Apple Developer account).
To ease development with different versions of the SDK that require different versions of Xcode, we require Xcode to be in a non-standard location (based on the Xcode version).
For example Xcode 7.0 must be installed in /Applications/Xcode7.app.
The recommended procedure is to download the corresponding Xcode dmg from Apple's Developer Center, extract Xcode.app to your system, and rename it before launching it the first time. Renaming Xcode.app after having launched it once may confuse Xcode, and strange errors start occuring.
-
Mono MDK.
The build will tell you if you need to update, and where to get it.
-
Xamarin Studio.
The build will tell you if you need to update, and where to get it.
-
You can also provision some of the dependencies with an included script:
$ ./system-dependencies.sh --provision-[xcode|xamarin-studio|mono|all]
Quick build & install
Follow the following steps to build and install Xamarin.iOS and Xamarin.Mac:
-
Clone this repository and its submodules
$ git clone --recursive git@github.com:xamarin/xamarin-macios.git $ cd xamarin-macios
-
Fetch dependencies and build everything
$ make world
-
Make sure permissions are OK to install into system directories (this will ask for your password)
$ make fix-install-permissions
-
Install into the system
$ make install-system
-
Build again after any local changes
Don't use
make world
again to rebuild, because it resets dependencies and causes unnecessary rebuilds. Instead use the standardmake all install
(our Makefiles are parallel safe, which greatly speeds up the build):$ make all -j8 && make install -j8
Configure
There is a configure script that can optionally be used to configure the build. By default, everything required for both Xamarin.iOS and Xamarin.Mac will be built.
-
--disable-mac: Disable Mac-related parts.
-
--disable-ios: Disable iOS-related parts.
In both cases the resulting build will contain both iOS and Mac bits because:
-
Parts of the iOS build depends on Mac parts (in particular mtouch uses Xamarin.Mac).
-
The class libraries builds can not be disabled because a very common error is to end up with code that only works/builds in either iOS or Mac.
-
-
--enable-ccache: Enables cached builds with
ccache
(default ifccache
is found in the path). -
--disable-ccache: Disables cached builds with
ccache
, even if it is present. -
--disable-strip: If executables should be stripped or not. This makes it easier to debug native executables using lldb.
-
--help: Show the help.
Contributing
Mailing Lists
To discuss this project, and participate in the design, we use the macios-devel@lists.xamarin.com mailing list.
Chat
There is also a gitter chat room that can be used to discuss this project, and participate in the design:
Coding Guidelines
We use Mono's Coding Guidelines.
Reporting Bugs
We use Bugzilla to track issues.