107 строки
4.0 KiB
Markdown
107 строки
4.0 KiB
Markdown
# Xamarin.iOS & Xamarin.Mac #
|
||
|
||
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.
|
||
|
||
## Build requirements ##
|
||
|
||
* Autoconf, automake and libtool.
|
||
|
||
You can use brew, or [this script](https://gist.github.com/rolfbjarne/3a979187ddd0855da073) 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
|
||
|
||
* 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](https://developer.apple.com/downloads/index.action?name=Xcode)
|
||
(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:
|
||
|
||
1. Clone this repository and its submodules
|
||
|
||
$ git clone --recursive git@github.com:xamarin/xamarin-macios.git
|
||
$ cd xamarin-macios
|
||
|
||
2. Fetch dependencies and build everything
|
||
|
||
$ make world
|
||
|
||
3. Make sure permissions are OK to install into system directories (this will ask for your password)
|
||
|
||
$ make fix-install-permissions
|
||
|
||
4. Install into the system
|
||
|
||
$ make install-system
|
||
|
||
## 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 if `ccache` 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](http://lists.xamarin.com/mailman/listinfo/macios-devel) mailing list.
|
||
|
||
### Coding Guidelines
|
||
|
||
We use [Mono's Coding Guidelines](http://www.mono-project.com/community/contributing/coding-guidelines/).
|
||
|
||
### Reporting Bugs
|
||
|
||
We use [Bugzilla](https://bugzilla.xamarin.com/newbug) to track issues.
|
||
|