Open Radar

 
This is a “Developer Experience” suggestion for Xcode.

When the auto-completion popover is displayed while writing code in Xcode, it would be extremely helpful for the popover to display the platform/version requirements for the method(s) suggested when they are highlighted.

Currently, the method signature is displayed as well as a short description. But if the method you pick from the list won’t work with your project (for example, it is only supported in iOS 16.0+ and your project supports iOS 15.0+) you cannot tell this until you pick the method and wait for an error to appear.

It would be much more efficient if the platform/version requirements for each method were displayed for the selected method so that you can tell immediately if it won’t work.

Ideally, there should be some indication within the auto-completion popover itself that the method won’t work. Perhaps a short text string saying “Method is only available in iOS 16.0 or newer” or similar, in red. You might also consider displaying unsupported methods in the list in red (or some other indicator) so that I know that I will likely want to look at the other options first.

I have attached a screenshot of the auto-completion popover showing an example of a method that does not work in my project. I’ve also attached another screenshot, from Xcode’s documentation for a given method, showing the kind of information I’d like to see in the auto-completion popover.