Bug 59940 - Should give user friendly message if open storyboard in xcode and try to build
Summary: Should give user friendly message if open storyboard in xcode and try to build
Alias: None
Product: Xamarin Studio
Classification: Desktop
Component: iOS add-in (show other bugs)
Version: unspecified
Hardware: PC Mac OS
: Lowest enhancement
Target Milestone: Future Cycle (TBD)
Assignee: Jeffrey Stedfast
Depends on:
Reported: 2017-10-04 03:18 UTC by Bret Johnson [MSFT]
Modified: 2018-01-10 14:11 UTC (History)
6 users (show)

Tags: papercut
Is this bug a regression?: ---
Last known good build:

Notice (2018-05-24): bugzilla.xamarin.com is now in read-only mode.

Please join us on Visual Studio Developer Community and in the Xamarin and Mono organizations on GitHub to continue tracking issues. Bugzilla will remain available for reference in read-only mode. We will continue to work on open Bugzilla bugs, copy them to the new locations as needed for follow-up, and add the new items under Related Links.

Our sincere thanks to everyone who has contributed on this bug tracker over the years. Thanks also for your understanding as we make these adjustments and improvements for the future.

Please create a new report for Bug 59940 on Developer Community or GitHub if you have new information to add and do not yet see a matching new report.

If the latest results still closely match this report, you can use the original description:

  • Export the original title and description: Developer Community HTML or GitHub Markdown
  • Copy the title and description into the new report. Adjust them to be up-to-date if needed.
  • Add your new information.

In special cases on GitHub you might also want the comments: GitHub Markdown with public comments

Related Links:

Description Bret Johnson [MSFT] 2017-10-04 03:18:36 UTC
Some new Xamarin (but experienced iOS native) devs, like this one https://twitter.com/azamsharp/status/915391382377959424, start using Xamarin by creating a new project and opening the storyboard in Xcode to make some UI changes. It's probably not surprising that iOS native devs would do that.
And then this user at least tried to build the project in XCode, seeing the confusing message "Invalid iOS deployment version..." (see Twitter link above for full message).

Clearly this user didn't understand the expected workflow, that you aren't supposed to build in Xcode, but this message caused them to think the whole experience was broken (and spread that message to their Twitter followers).

We should instead have the xcodeproj we create output an user friendly message for the build that educates the user on the expected workflow here.  Something like:

"This is a stub project for Storyboard editing. Don't build it in XCode. Instead make your UI changes, save them, and go back to Visual Studio to build and run your project there."

It can be a custom build step, with an echo of the message and an exit 1 or something like that, to fail the build.
Comment 1 Vincent Dondain [MSFT] 2017-10-04 15:52:34 UTC

So I'm not sure we can hack the .xcodeproj to generate custom build errors (something to look into).

However we could (and maybe should) certainly show the user an alert (tutorial style) the first time they try to open a storyboard in Xcode (show that only once).

This would let us explain what our "open storyboard in Xcode" story is about (maybe link to some documentation.

We could explain the limits: it's a generated project that can have build errors (but it doesn't really matter because we'll be able to import the changes to VSMac anyway).

We could also promote our iOS designer there and explain its great features (that Xcode doesn't have), mostly that it removes this complex drag and drop concept with outlets.

Anything that PM and docs think we should mention.