Welcome to the Windows Bridge for iOS Project
The Windows Bridge for iOS (also referred to as WinObjC) is a Microsoft open-source project that provides an Objective-C development environment for Visual Studio and support for iOS APIs. The bridge allows you to create Universal Windows Platform (UWP) apps that will run on many Windows devices by re-using your Objective-C code and iOS APIs alongside Windows 10 features like Cortana and Windows Notifications.
Download and Installation
To use the bridge you'll need:
- The latest pre-built Windows Bridge for iOS SDK, that you can download here. Click on the winobjc.zip file under Downloads to start the download and extract it to the local directory of your choice (example: C:\winobjc) when complete.
- Windows 10, build 10586 or higher. Validate your version number here.
- Visual Studio 2015 Update 3 with Windows developer tools. Visual Studio 2015 Community is available for free here. Select (at least) the following components during installation:
- Programming Languages -> Visual C++
- Universal Windows App Development Tools (all)
Getting Started With the Bridge
Importing your Xcode Project
When using the bridge, the first thing you'll want to do is generate a Visual Studio solution from your Xcode project:
Open the Windows Command Prompt (type cmd in the Start Menu to find it) and navigate to your Xcode project directory using the cd command. Note: use the directory containing your .workspace or .xcodeproj folder.
C:\> cd C:\MyProject
Run the vsimporter tool from the bin directory of the bridge SDK you downloaded. This will generate the Visual Studio Solution:
Open the generated Visual Studio solution with the command:
Configuring Visual Studio
Once your solution is opened in Visual Studio, you'll want to enable Objective-C syntax highlighting and debugging.
- Installing the Syntax Highlighting Extension
- To enable Objective-C syntax highlighting in Visual Studio, navigate to the bin directory of the SDK and double click on objc-syntax-highlighting.vsix to launch the installer.
- Setup Objective-C Debugging
- To setup Objective-C debugging in Visual Studio, follow the instructions on the Debugging page of the wiki.
Analyzing your App
After importing your project, we strongly suggest using the App Analysis Tool to have a better understanding of the compatibility of your app with the bridge.
Building & Running the Samples
A great way to learn more about the bridge and its features is building and running the samples of the SDK, which contain many code examples. We recommend starting with the WOCCatalog sample app, which demonstrates an assortment of iOS and XAML UI controls:
- Navigate to the samples/WOCCatalog directory of the bridge SDK
- Double-click on the WOCCatalog-WinStore10.sln solution to open it in Visual Studio
- In Visual Studio, right-click on the WOCCatalog (Universal Windows) project
- Select Set as StartUp project
- Use Ctrl-F5 to build and run the app
For more detailed step by step instructions, see the Quick Start Tutorial page of the wiki.
Resources & Documentation
The following resources will help you get started. For more information, check out:
- Wiki, for documentation and tutorials
- Development Roadmap, detailing our highest priorities
- App Analysis Tool, to evaluate the compatibility of your app with the bridge
- Website on Windows Dev Center, for evaluation virtual machines
- Quick Start Challenge, for a quick hands-on introduction to the bridge
- FAQ, with common questions and issues
- The iOS Bridge Samples Repo, for sample apps and code using the bridge
There are many ways to contribute to the Windows Bridge for iOS:
- Submit bugs & issues and help us verify fixes as they are checked in.
- Review source code changes.
- Submit a bug fix or feature implementation via pull request.
- Follow @WindowsDev on Twitter and join the discussion using the #WinObjC hashtag.
- Engage with other users and developers on StackOverflow and tag your questions with WinObjC.
See our contribution guidance in the wiki for more details on how to contribute to the project.
See Microsoft's privacy statement for more information.
- Do not use the Download ZIP option via the "Clone or download" button at the top of the page. You will not be able to build the bridge using the resulting .zip file. See "I'm getting errors after downloading the bridge through the "Download ZIP" button on Github. What should I do?" for more information.