Training
Learning path
Solution Architect: Design Microsoft Power Platform solutions - Training
Learn how a solution architect designs solutions.
This browser is no longer supported.
Upgrade to Microsoft Edge to take advantage of the latest features, security updates, and technical support.
Important
Visual Studio App Center is scheduled for retirement on March 31, 2025. While you can continue to use Visual Studio App Center until it is fully retired, there are several recommended alternatives that you may consider migrating to.
Note
Supported versions and requirements App Center supports Portable Class Library (PCL) and .NET Standard projects. Refer to Cloud Build Machines for versions of .NET Standard. App Center doesn't support Components from the Xamarin Component Store and we advise using NuGet packages whenever available. If you're using a Component that can't be replaced, contact us. See help and feedback.
To start building your first Xamarin iOS app, you'll need to:
Note
For the app to run on a real device, the build needs to be code signed with a valid provisioning profile and a certificate.
If you haven't previously connected to your repository service account, you must connect it. Once your account is connected, select the repository where your iOS project is located. To set up a build for a repository, you need admin and pull permission for it.
After selecting a repository, select the branch you want to build. By default all the active branches will be listed.
Before your first build, the Xamarin project needs to be configured.
App Center automatically detects the solution and project files in your repository if they're located within the range of analysis. Select the .sln or .csproj/.fsproj you want to build.
Note
For best performance, the analysis is currently limited to two directory levels for .sln and four directory levels for .csproj/fsproj including the root of your repository.
In your code, make sure to disable Android and UWP projects for build configs that are intended for iOS builds: go into the solution's configuration mappings, and for all mappings that target iPhone and iPhoneSimulator, uncheck all projects targeting other platforms. This change will ensure that when the .sln is building, it won't attempt to build the other projects. There's more solution configurations mapping information you can read.
To build from a .csproj/.fsproj file all the referenced projects (for example, your PCL project) must contain the configuration with the same name as the one from your source iOS project. So, if you run the Debug configuration for the simulator in App Center, your PCL project must have the Debug|iPhoneSimulator configuration. In case they don't exist and to prevent further errors we add such configurations before building your projects. Those configurations have basic default settings for Debug and Release only.
Select the configuration you want to build with. The configurations are automatically detected depending on the source file picked in the previous step.
App Center allows using different Mono environments bundled with respective Xamarin.iOS SDK for your build to maintain backward compatibility while releasing a support for new features. The default Mono for a new branch configuration will be the latest stable one. You may choose to use one of the previous Mono environments to build older versions of frameworks or libraries. When you choose a different Mono version, you'll see the Xamarin.iOS SDK version that's bundled with it. To track Xamarin SDK version updates, you can read posts in the Xamarin release blog.
Proper .NET version will be selected automatically based on Xamarin.iOS version used for build and can't be overwritten. You can view the mapping of Xamarin.iOS to the .NET used by our services in the table below:
Xamarin.iOS | .NET |
---|---|
13.20 | 3.1.401 |
14.0 | 3.1.401 |
14.2 | 3.1.401 |
14.4 | 3.1.401 |
14.6 | 5.0.100 |
14.8 | 5.0.100 |
14.10 | 5.0.100 |
14.14 | 5.0.100 |
14.16 | 5.0.100 |
14.20 | 5.0.100 |
15 | 5.0.100 |
15.2 | 5.0.100 |
15.4 | 5.0.100 |
15.6 | 5.0.100 |
15.8 | 5.0.100 |
15.10 | 5.0.100 |
15.12 | 5.0.100 |
16.0 | 5.0.100 |
16.0 (.NET 6) | 6.0.405 |
16.1 | 6.0.405 |
16.2 | 6.0.405 |
Currently supported versions of Xamarin require Xcode 11.7 or higher
By default, a new build is triggered every time a developer pushes to a configured branch. If you prefer to trigger a new build manually, you can change this setting in the configuration pane.
Simulator builds can only be ran on simulators and can't be installed on the device, however the builds complete faster than device builds. If your build isn't a simulator build, you need to upload code signing files in the next step.
When enabled, the CFBundleVersion
in the Info.plist of your app automatically increments for each build. The change happens pre-build and won't be committed to your repository.
A successful device build will produce an IPA file. To install the build on a device, it needs to be signed with a valid provisioning profile and certificate. To sign the builds produced from a branch, enable code signing in the configuration pane and upload a provisioning profile (.mobileprovision
) and a valid certificate (.p12
), along with the password for the certificate. You can read more about code signing and device provisioning of Xamarin iOS apps in the Xamarin documentation.
Apps with app or watchOS extensions require an additional provisioning profile per extension to be signed.
Note
There's an existing issue when running nuget restore
in projects containing Xamarin watchOS apps.
Building a watchOS app on App Center without a workaround will result in an error:
Project <project> is not compatible with xamarinios10 (Xamarin.iOS,Version=v1.0) / win-x86. Project <project> supports: xamarinwatchos10 (Xamarin.WatchOS,Version=v1.0)
.
To build watchOS apps on App Center, a workaround is required. Within the containing iOS project, which references to the Watch App, an additional line must be included:
<ReferenceOutputAssembly>False</ReferenceOutputAssembly>
Example WatchApp reference with workaround:
<ProjectReference Include="..\MyWatchApp\MyWatchApp.csproj">
<Project>{59EB034F-3D29-43A5-B89F-124879504771}</Project>
<Name>MyWatchApp</Name>
<IsWatchApp>True</IsWatchApp>
<ReferenceOutputAssembly>False</ReferenceOutputAssembly>
</ProjectReference>
Use your newly produced .ipa file to test if your app starts on a real device. Launch testing adds about 10 more minutes to the build time. You may want to check more comprehensive guide about testing your builds
If the NuGet.config file is checked-in for the repository and sitting next to the .sln or the root level of your repository, App Center restores your private NuGet feeds when they're added as shown in the example below. Credentials can be added safely by using environment variables:
<?xml version="1.0" encoding="utf-8"?>
<configuration>
<packageSources>
<add key="nuget" value="https://api.nuget.org/v3/index.json" />
<add key="MyGet" value="https://www.myget.org/F/MyUsername/api/v2/index.json" />
<add key="MyAuthNuget" value="https://nuget.example.com/v2/index.json" />
</packageSources>
<activePackageSource>
<add key="All" value="(Aggregate source)" />
</activePackageSource>
<packageSourceCredentials>
<MyAuthNuget>
<add key="Username" value="$USER_VARIABLE" />
<add key="ClearTextPassword" value="$PASSWORD_VARIABLE" />
</MyAuthNuget>
</packageSourceCredentials>
</configuration>
If you have complex configurations and need more information, refer to Configuring NuGet behavior.
You can configure each successful build from a branch to be distributed to a previously created distribution group. You can add a new distribution group from within the Distribute section. There's always a default distribution group called "Collaborators" that includes all the users who have access to the app.
Once you save the configuration, a new build will be automatically kicked off.
After a build has been triggered, it can be in the following states:
For a completed build (succeeded or failed), download the logs to understand more about how the build went. App Center provides an archive with the following files:
|-- 1_build.txt (this is the general build log)
|-- build (this folder contains a separate log file for each build step)
|-- <build-step-1> (e.g. 2_Get Sources.txt)
|-- <build-step-2> (e.g. 3_Pod install.txt)
|--
|-- <build-step-n> (e.g. n_Post Job Cleanup.txt)
The build step-specific logs (located in the build/
directory of the archive) are helpful for troubleshooting and understanding in what step and why the build failed.
The .ipa
is an iOS application archive file that contains the iOS app. If the build has been correctly signed, the .ipa
can be installed on a real device, corresponding to the provisioning profile used when signing. There are more details about code signing and distribution with App Center.
If the app is a simulator build, you can run the .app
file on a simulator, but you can't use it on a real device.
Symbol files are only generated for device builds. The .dsym files contain the debug symbols for the app.
.dsym
file for a build to display human readable (symbolicated) crash reports..dsym
file to display human readable crash reports.Training
Learning path
Solution Architect: Design Microsoft Power Platform solutions - Training
Learn how a solution architect designs solutions.