Known Issues & Workarounds

PDF for offline use
Related Links:

Let us know how you feel about this

Translation Quality


0/250

Persistence of CultureInfo across cells

Setting System.Threading.CurrentThread.CurrentCulture or System.Globalization.CultureInfo.CurrentCulture does not persist across workbook cells on Mono-based Workbooks targets (Mac, iOS, and Android) due to a bug in Mono's AppContext.SetSwitch implementation.

Workarounds

  • Set the application-domain-local DefaultThreadCurrentCulture:
using System.Globalization;
CultureInfo.DefaultThreadCurrentCulture = new CultureInfo("de-DE")
  • Or, update to Workbooks 1.2.1 or newer , which will rewrite assignments to System.Threading.CurrentThread.CurrentCulture and System.Globalization.CultureInfo.CurrentCulture to provide for the desired behavior (working around the Mono bug).

Unable to use Newtonsoft.Json

Workaround

  • Update to Workbooks 1.2.1, which will install Newtonsoft.Json 9.0.1. Workbooks 1.3, currently in the alpha channel, supports versions 10 and newer.

Details

Newtonsoft.Json 10 was released which bumped its dependency on Microsoft.CSharp which conflicts with the version Workbooks ships to support dynamic. This is addressed in the Workbooks 1.3 preview release, but for now we have worked around this by pinning Newtonsoft.Json specifically to version 9.0.1.

NuGet packages explicitly depending on Newtonsoft.Json 10 or newer are only supported in Workbooks 1.3, currently in the alpha channel.

Code Tooltips are Blank

There is a bug in the Monaco editor in Safari/WebKit, which is used in the Mac Workbooks app, that results in code tooltips rendering without text.

Workaround

  • Clicking on the tooltip after it appears will force the text to render.

  • Or update to Workbooks 1.2.1 or newer

SkiaSharp renderers are missing in Workbooks 1.3

Starting in Workbooks 1.3, we've removed the SkiaSharp renderers that we shipped in Workbooks 0.99.0, in favor of SkiaSharp providing the renderers itself, using our SDK.

Workaround

  • Update SkiaSharp to the latest version in NuGet. At the time of writing, this is 1.57.1.

Xamarin Workbook

If it's not already installed, install the Xamarin Workbooks app first. The workbook file should download automatically, but if it doesn't, just click to start the workbook download manually.