Skip to content

Official API Review for Microsoft.Windows.Storage.Pickers #5634

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged

Conversation

DinahK-2SO
Copy link
Contributor

@DinahK-2SO DinahK-2SO commented Jul 18, 2025

Description
This PR contains all design specs of the Microsoft.Windows.Storage.Pickers API set.
Please start with specs/Storage.Pickers/Microsoft.Windows.Storage.Pickers.md

Note:
This PR is created for the official API review of Microsoft.Windows.Storage.Pickers API set.

Since there're some documents on the main branch already, the files are copied from dev/Interop/StoragePickers and updated for official review.

After the review is completed, we will remove dev/Interop/StoragePickers and check in this officially reviewed version.

Copy link
Member

@Scottj1s Scottj1s left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

awaiting next iteration

@DinahK-2SO DinahK-2SO force-pushed the user/DinahK-2SO/storage_pickers_official_API_review branch from 73a70d3 to 3e36324 Compare July 25, 2025 07:11
DinahK-2SO added a commit that referenced this pull request Jul 25, 2025
This PR implements suggestions raised in the official API review of `Microsoft.Windows.Storage.Pickers` APIs (#5634 ).

1. Removal of `SettingsIdentifier` Property.
2. Replace method `TrySetSuggestedSaveFilePath` with the property's own setter.
3. For FileSavePicker, updated underlying logic to ensure that the file name in `SuggestedSaveFilePath` takes precedence over the `SuggestedFileName`, even if the folder of `SuggestedSaveFilePath` does not exists.
    This is also the existing behavior of UWP pickers ( the `Windows.Storage.Pickers`)
4. Test Additions and Updates.
5. XML and Feature Flag Cleanup.
DinahK-2SO added a commit that referenced this pull request Jul 25, 2025
This PR implements suggestions raised in the official API review of `Microsoft.Windows.Storage.Pickers` APIs (#5634 ).

1. Removal of `SettingsIdentifier` Property.
2. Replace method `TrySetSuggestedSaveFilePath` with the property's own setter.
3. For FileSavePicker, updated underlying logic to ensure that the file name in `SuggestedSaveFilePath` takes precedence over the `SuggestedFileName`, even if the folder of `SuggestedSaveFilePath` does not exists.
    This is also the existing behavior of UWP pickers ( the `Windows.Storage.Pickers`)
4. Test Additions and Updates.
5. XML and Feature Flag Cleanup.
LegendaryBlair pushed a commit that referenced this pull request Jul 25, 2025
This PR implements suggestions raised in the official API review of `Microsoft.Windows.Storage.Pickers` APIs (#5634 ).

1. Removal of `SettingsIdentifier` Property.
2. Replace method `TrySetSuggestedSaveFilePath` with the property's own setter.
3. For FileSavePicker, updated underlying logic to ensure that the file name in `SuggestedSaveFilePath` takes precedence over the `SuggestedFileName`, even if the folder of `SuggestedSaveFilePath` does not exists.
    This is also the existing behavior of UWP pickers ( the `Windows.Storage.Pickers`)
4. Test Additions and Updates.
5. XML and Feature Flag Cleanup.
DinahK-2SO added a commit that referenced this pull request Jul 29, 2025
There's an open question regarding the design of SuggestedSaveFilePath during the official API review #5634

Hence hiding this property from preview release.

Related PR on preview-1: #5664
DinahK-2SO added a commit that referenced this pull request Jul 29, 2025
There's an open question regarding the design of SuggestedSaveFilePath during the official API review #5634

Hence hiding this property from preview release.
Copy link
Member

@Scottj1s Scottj1s left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Success!

@DinahK-2SO
Copy link
Contributor Author

/azp run

Copy link

Azure Pipelines could not run because the pipeline triggers exclude this branch/path.

@DinahK-2SO DinahK-2SO merged commit 7388ca4 into main Aug 3, 2025
2 checks passed
@DinahK-2SO DinahK-2SO deleted the user/DinahK-2SO/storage_pickers_official_API_review branch August 3, 2025 12:41
DinahK-2SO added a commit that referenced this pull request Aug 3, 2025
* create the files for official API review

* add spec notes for official review

* update doc

* add details; graceful

* update the specs

* Resolve comments; Fix typos and grammer errors in doc.

* FileSavePicker.SuggestedFolder
LegendaryBlair pushed a commit that referenced this pull request Aug 3, 2025
…ge.Pickers to 1.8-stable (#5676)

* FileSavePicker.SuggestedFolder (#5669)

* SuggestedFolder

* update tests

* Official API Review for Microsoft.Windows.Storage.Pickers (#5634)

* create the files for official API review

* add spec notes for official review

* update doc

* add details; graceful

* update the specs

* Resolve comments; Fix typos and grammer errors in doc.

* FileSavePicker.SuggestedFolder

* remove old specs
@charlesroddie
Copy link

charlesroddie commented Aug 3, 2025

How is there a whole review process and no mention of the fact that you can't use pickers in AppContainers? All comments from community (in previous PRs) and all the existing issues about pickers get ignored in creating this spec? App developers that want to distribute to end users with reasonable security need to wait another 5 years for a V3 spec?

@DinahK-2SO @oldnewthing @kmahone @codendone @yeelam-gordon @Scottj1s

DinahK-2SO added a commit that referenced this pull request Aug 4, 2025
The official spec has been merged via
* #5634 

This PR removes the unofficial spec.
@DinahK-2SO
Copy link
Contributor Author

DinahK-2SO commented Aug 13, 2025

How is there a whole review process and no mention of the fact that you can't use pickers in AppContainers? All comments from community (in previous PRs) and all the existing issues about pickers get ignored in creating this spec? App developers that want to distribute to end users with reasonable security need to wait another 5 years for a V3 spec?

Hi @charlesroddie , thanks for highlighting this important topic!

This spec primarily targets enabling picker functionality when running in elevated mode (i.e., as administrator). While AppContainer scenarios are not in the scope of this spec, I deeply appreciate your interest and enthusiasm.

The new pickers support containerized AppContainer with win32-isolation, which is also in preview. Please stay tuned for future updates as we continue to expand storage picker capabilities.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

7 participants