Stable Release: Cycle 8 w/ iOS 10 and Xcode8 Support

We are releasing our next major feature release, called Cycle 8 to the Stable channel. These build also support the final Apple releases of iOS 10 and Xcode 8.

If you are wondering how to embed new iOS 10 functionality in your apps, you can check out the samples available here to get a head start:

  • AVCamBarcode – using AVFoundation to Detect Barcodes and Faces.
  • Flags – a demonstration of automatic RTL support in Asset Catalogs and UIStackViews.
  • IceCreamBuilder – app extension that interacts with the Messages app.
  • RawExpose – shows a RAW image asset management system.
  • SpeakToMe – using Speech Recognition with AVAudioEngine.
  • SpeedSketch(sitting in PR now) – leveraging touch input for a drawing application.
  • WatchPuzzle – how to work with low-level graphics in watchOS.

The issues addressed below are only the highest severity ones, so please check out the product release notes to see all the fixes and known issues for this release.

If you see a behavior that looks suspicious in these versions, and if it isn’t clear whether one of the known issues in the release notes matches the problem, please file a quick bug report to alert the team.

If you notice an error in this blog post or have trouble downloading one of the installer packages, please let us know in the corresponding forum thread.

Known Issues 

  • [Xamarin for Visual Studio]Upstream non-standard behavior of NuGet Package Manager extension (Xamarin tracking bug 44146) triggered by XamarinVS 4.2 – “GetFullVsVersionString must be called on the UI thread” error appears when attempting to open Manage NuGet Packages for Solution, blocking the use of the NuGet package manager on certain systems
    • Temporary workaround: Install this small extension from the Xamarin VS team that will force the NuGet Package Manager to load before the Xamarin extensions.
    • Alternate temporary workaround: Before opening any projects, open Tools > NuGet Package Manager > Package Manager Settings to force the NuGet Package Manager extension to load before the Xamarin extensions.
  • [Xamarin.iOS]44225 – “Error: TrustFailure (CertificateUnknown)” when using Apple TLS handler to access HTTPS servers that use virtual domains (via Server Name Indication).
    • Partial temporary workaround: Under Project Options > iOS Build, change the SSL/TLS implementation setting back to the old default Mono (TLS v1.0).
  • [Xamarin for Visual Studio], [Xamarin Studio]43566 – The iOS Designer initialization process will cause any running iOS 10 simulator to become non-responsive. The designer initialization happens when opening an iOS project in Xamarin Studio and during the connection to the remote Mac in Visual Studio. This issue does not affect Xcode 7.3, iOS 9.3 (and lower) simulators.
    • Workaround: Quit and restart the simulator after the designer has initialized. You can then proceed to use the simulator again as normal.
  • [Xamarin.Android]44268 – “Unexpected libzip error: Inval” when building projects that reference any of the Android Support Libraries on Windows if the user name contains any accented characters.
    • Temporary workaround: Create and log in with a Windows user account that has only ASCII letters in the user name.
    • Alternate workaround: Add a XAMARIN_CACHEPATH environment variable under Control Panel > System > Advanced system settings > Environment Variables, and set it to a path that uses only ASCII letters in the directory names.
  • [Xamarin.Android]44184 – “The “BuildApk” task failed unexpectedly. Xamarin.Tools.Zip.ZipException: Entry has been changed” when attempting to archive or deploy apps that use certain NuGet packages.
  • [Xamarin.UITest] – Xcode 8 removes the UI Automation API, causing “SetUp : System.InvalidOperationException : Sequence contains no matching element … at System.Linq.Enumerable.First[TSource] … at Xamarin.UITest.iOS.Instruments.GetAutomationTemplatePath ()” when attempting to use UITest locally.
    • Candidate fix: Update to the Xamarin.UITest 2.0.0 Beta prerelease, which is based on Calabash 0.20 and includes a new API that uses XCUITest rather than UI Automation.
    • Alternate temporary workaround: Keep using Xcode 7, or just keep Xcode 7 installed in the default location and unpack Xcode 8 side-by-side to a custom location.
  • [Xamarin Studio]43655 – Cannot open ‘API Documentation’ in XS on Mac.
  • [Xamarin Studio]43675 – New “run configurations” menu prevents seeing which emulator is selected.
  • [Xamarin for Visual Studio] – 40767: Collection View and Table View are rendered differently on the iOS designer and the actual simulator
  • [Xamarin.iOS] – 42443 –  ServicePointTest (System) tests crash on tvOS device
  • [Mono Framework] 44429 – Upstream issue in OS X Sierra Beta, P/Invoke to NSLog or os_log currently crashes.
    • Workaround – Use System.Console.WriteLine() instead of using NSLog directly
    • Alternate workaround: Create a small C static library which invokes NSLog for you, link it into your application, and invoke it instead.

Intentional Changes

  • [Xamarin.iOS] – “Error MT0091: This version of Xamarin.iOS requires the iOS 10.0 SDK (shipped with Xcode 8.0) when the managed linker is disabled. Either upgrade Xcode, or enable the managed linker.” This message will appear when building using Xcode 7.3 or older with Xamarin.iOS 10. The issue arises because Xamarin.iOS 10 is built to include the Xcode 8 symbols. When enabled, the Xamarin managed linker can remove these unused symbols to allow building successfully against older versions of Xcode.
    • Fix: Update to Xcode 8, or enable the Xamarin linker by choosing a setting other than Don’t link under Project properties > iOS Build > Linker behavior.
  • [Xamarin for Visual Studio]Build > Export Android Package (.apk) and Tools > Android > Publish Android App have been replace by the Build > Archive command that is part of the new Android Archive Manager and Publishing workflow.

Products Released

  • Xamarin Studio
    • Release Notes
    • Major Issues Addressed:
      • 42554 – Typing into the search box is corrupting memory and crashing XS
      • 43210 – User is not able to launch an activity by explicitly specifying which activity to launch for Android application in XS
      • 43187 – Quick build/run menu selector does not include run configurations
      • 43949 – Unable to set SDK and NDK path in XS
      • 43888 – Unable to open iOS designer in XS
      • 43678 – Unable to open ‘Create Layout Variation’ window on clicking ‘New Version’ button
      • 44036 – Cannot create new multiplatform projects
      • 42389 – Constant spinwheels / hangs when editing, scrolling, or searching in the document editor with a large solution using XS 6.1
      • 42325 – Xamarin.Forms projects using montouch.dll do not work in the previewer
      • 42206 – Incorrectly detecting xamarin forms xaml
      • 42103 – User is not able to run Library project in windows XS, if they have a custom execution command
      • 42041 – Unable to open .fsx file in F# Interactive pad of Windows XS
      • 42035 – Getting “Session termination detected” in F# Interactive pad and it stop working
      • 42012 – Reset button of F# Interactive pad does not reset its saved session
      • 41889 – Not getting “Broadcast Receiver 1 invoked !” message in application output, when running Xamarin.Android project with a broadcast receiver, explicitly
      • 41838 – iOS application throws exception, while running in Background Fetch Mode
      • 41785 – ‘Arguments’ and ‘Environment variable’ are not getting saved for iOS application in XS
      • 41757 – User is not getting get option to choose to run watchkit application in Glance mode or notification via Run dropdown in XS
      • 41756 – User is not able to run project in XS, when Multi Startup option is selected
      • 41688 – User is not able to execute library project with custom execution command in XS
      • 41679 – User is not able to Archive for iOS Publishing on MAC
      • 41646 – User is not able to Add a Custom Configuration in XS
      • 40497 – XA is not recognized, looking for mandroid.exe
      • 40422 – The roslyn workspace can’t be queried while it’s loading
      • 43168 – Getting error in Android Previewer even after building or rebuilding the project
      • 42969 – Apps won’t launch on simulators or devices using Xcode8 beta 4
      • 41784 – error ‘object reference not set to instance of object’ in Forms Previewer when opening any XAML file.
      • 42470 – Remove Other/Miscellaneous/MonoMac templates
      • 41905 – copy classes containing regions delete the keys
      • 41687 – Xamarin Studio Community Version 6.0 (build 5174) freezes when users click on “Navigate” -> “Find Reference”
      • 41685 –  Xamarin Studio Community Version 6.0 (build 5174) does not correctly save .cs files
  • Xamarin.VS
    • Release Notes
    • Major Issues Addressed:
      • 43300 – Intermittent disconnection of VS from Build Host while working with iOS application.
      • 43037 – Unable to install XVS builds.
      • 43602 – “Device Log” window does not open in Visual Studio.
      • 43565 – Visual Studio often hangs (pauses, freezes) during `TastyConfig.DebugLaunch()` on second deployment attempt
      • 43650 – User is not getting simulator for Watckit OS1 application in VS dropdown
      • 43454 – User is not able to run Watch OS1 application with VS, application gets terminated
      • 44046 – Getting build error for iOS/tvOS template
      • 43976 – Can’t open WatchOS interface.storyboard in designer
      • 43884 – Unable to open iOS designer in VS
      • 43232 – Unable to build Blank Mac App(Cocoa App), getting ‘Illegal characters in path’ error.
      • 42958 – Getting “DetectSdkLocations — FAILED” error on building Blank Mac application on Visual Studio
      • 42757 – Getting build error in Android Designer when building the project after dragging the custom control to the designer in VS
      • 42688 – Getting “Required service ‘EnvDTE80.DTE2’ not found” error on opening Android Designer
      • 42435 – Getting “‘ResolveUinversalTypeIdentifiers’ task failed unexpectedly” error on building ‘Spritekit Game’ or ‘Scenekit Game’ Mac app solution in VS
      • 42397 – The forms previewer is disabled in cycle8
      • 42113 – xaml files in shared asset projects don’t work in the forms previewer
      • 41815 – Xamarin.Forms.Templates.VisualStudio.dll gets loaded on VS startup even after second time+
      • 40546 – No Xamarin/VS License is activated and keeps showing VS community
      • 43018 – unable to select an event handler which has been already defined
      • 42422 – Game Controller checkbox Settings remembered on reopeining the Info.plist of tvOS application
      • 41915 – Xamarin breaks VSTU debugger integration with Unity 3D and Visual Studio
      • 41507 – Connecting from Visual Studio Community 2015 to Mac host
  • Xamarin.iOS
    • Release Notes
    • Major Issues Addressed:
      • 43373 – Unable to upload application to device due to an error “Could not load the framework ‘libswiftos.dylib’ (path: /Applications/” with Xcode8-beta6 update
      • 43837 – Unexpected Error MT0000 when building in Release configuration and targeting a device (not sim)
      • 40936 – iOS app crash when taking snapshots
      • 42099 – User is not able to run watchOS2 app in XS
      • 42750 – Deploying an iOS app to iPhone 6S crashes when a breakpoint is set
      • 42549 – Getting build error ‘Could not AOT the assembly’ in release mode on iOS device
      • 42493 – WatchOS2 app is not launching on Watch Simulator
      • 40788 – Invalid assembly name System.ServiceModel.Web
      • 42452 – Unsupported type encoding : _GLKVector4={?=ffff}{?=ffff}{?=ffff}[4f])16 / GLKMatrix4 = {?=ffffffffffffffff}[16f])16
  • Xamarin.Android
    • Release Notes
    • Major Issues Addressed:
      • 43268 – Android application crashes when launched on Android device, when running a project with a service in XS
      • 42646 – Error XA2006: Reference to metadata item ‘Android.Views.DecorCaptionShade’ when attempting to build codegen tests in release
      • 43487 – ‘System.DllNotFoundException: sqlite3’ thrown when trying to use sqlite with Cycle8
      • 42814 – Deploy to Android device fails when setting a breakpoint
      • 42835 – Android projects which use Support packages are failing to build on Windows due to issue extracting resources
      • 42521 – Applications crashing on startup due to No original dex files found
      • 42469 – Assertion “fixed_type_allocator_indexes [type] == slot’ not met” causing apps to crash on startup
      • 42912 – Release deployments are crashing immediately on startup “No assemblies found in ‘(null)’ or ‘<unavailable>’.”
      • 41706 – TypeLoadException thrown when trying to compile a binding project.
      • 40437 – All builds are now failing on windows due to error finding mandriod
  • Mono Framework
    • Release Notes
    • Major Issues Addressed:
      • 42864 –  “System.Net.WebException: Error: NameResolutionFailure” on second web request to certain raw IP addresses with HttpClient
      • 43305 – Standard Library dependency error on Xamarin Studio
      • 42408: WebClient.DownloadString returns 401 Unauthorized when using Basic authentication
      • 42938:  Compilation of netstandard PCL library with xbuild fails with… CSC: error CS0518: The predefined type …  is not defined or imported
      • 43636 – “Index was out of range. Must be non-negative and less than the size of the collection” in `System.Collections.Generic.List`1[T].set_Item()` when attempting to compile certain C# code involving tasks, async/await, and try/catch/finally
      • 33475 – Android app crash when taking snapshots
      • 41644 – Shutdown deadlock for Mono 4.5.1/master with Xamarin Studio/

Updating and downgrading

You can install this new version by checking for updates on the Stable updater channel.

You can downgrade back to the previous Cycle 7 Stable versions (from August 1, 2016) by manually reinstalling each old package. See the “Get the latest stable version of Cycle 7” section on your account page: (If you do not yet have a Xamarin login, you can create one.) If you have any trouble downloading the previous versions from that link, would like to install an even earlier set of versions, or simply would prefer an email with all the installer links you need, feel free to email

For Mac, you’ll also need to downgrade Xcode to 7.3.

Release Dates

Alpha – April 27th, 2016 (Evolve Conference)

Alpha 2 – July 13th, 2016

Alpha 3 – July 27th, 2016

Alpha 4 – Aug 2nd, 2016

Alpha 5– Aug 9th, 2016

Alpha 6 – Aug 12, 2016

Beta 1 – Aug 17th, 2016

Beta 2 – Aug 24th, 2016

Beta 3 – Aug 31st, 2016

Beta 4 – Sep 8th, 2016

Stable – This Release!