microsoft / microsoft/WindowsAppSDK

Deprecate and hide from Intellisense APIs that always return null, like Window.Current

Open
#1,660 19 comments 10 reactions 1 assignee View on GitHub

Nobody has claimed this yet.

api-design bug theme-FitAndFinish
Dominant language
C++
Stars
4.7k
Forks
471
Avg merge
3d 13h
Merged PRs (30d)
28

Description

**Describe the bug**

There are several APIs in our API surface that always return null and confuse developers, like `Window.Current` and also `Window.Dispatcher` and more. The presence of these non-functional APIs makes it more difficult to code and more difficult to migrate from UWP, since any developer would expect these APIs to work since they're there, but they actually just return null.

These APIs only worked in UWP, which was why we had them, but we need to clean up the API surface.

**Expected behavior**
These APIs should be removed, or at least marked deprecated. Since we're not going to be able to remove these before 1.0 GA and removing would be a breaking change, we're planning on marking them deprecated and hiding them from intellisense in 1.0 servicing or 1.1, and then removing in 2.0 with #1776.

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.