Document embedded Photo Picker APIs

[jonathanpeppers]

Documents 44 source-backed placeholders for embedded Photo Picker builder configuration, Parcelable behavior, provider creation, callbacks, and session surface packages. The remaining 57 scoped placeholders are namespace, generated binding infrastructure, or undocumented platform getters without safe authoritative descriptions.

Sources

• Android Developers: https://developer.android.com/reference/android/widget/photopicker/EmbeddedPhotoPickerFeatureInfo
• Android Developers: https://developer.android.com/reference/android/widget/photopicker/EmbeddedPhotoPickerClient
• Android Developers: https://developer.android.com/reference/android/widget/photopicker/EmbeddedPhotoPickerSession
• Android Developers: https://developer.android.com/reference/android/widget/photopicker/EmbeddedPhotoPickerProviderFactory
• Android Developers: https://developer.android.com/reference/android/os/Parcelable
• Android Open Source Project: https://android.googlesource.com/platform/packages/providers/MediaProvider/+/refs/heads/main/photopicker/framework/java/android/widget/photopicker/EmbeddedPhotoPickerFeatureInfo.java
• Android Open Source Project: https://android.googlesource.com/platform/packages/providers/MediaProvider/+/refs/heads/main/photopicker/framework/java/android/widget/photopicker/EmbeddedPhotoPickerClient.java
• Android Open Source Project: https://android.googlesource.com/platform/packages/providers/MediaProvider/+/refs/heads/main/photopicker/framework/java/android/widget/photopicker/EmbeddedPhotoPickerSession.java
• Android Open Source Project: https://android.googlesource.com/platform/packages/providers/MediaProvider/+/refs/heads/main/photopicker/framework/java/android/widget/photopicker/EmbeddedPhotoPickerProviderFactory.java

Validation

• Parsed all five modified XML documents with PowerShell's XML parser.
• Confirmed CRLF line endings in every modified XML document.
• Ran git diff --check and confirmed the diff is limited to five files in docs/xml/Android.Widget.PhotoPicker/.
• Recounted scoped To be added. placeholders from 101 to 57; the remaining entries have no safe authoritative coverage in the consulted Android reference and AOSP sources.

Refs #215

[jonathanpeppers]

@dalexsoto review

[jonathanpeppers]

@dalexsoto review

[dalexsoto]

The builder parameter docs omit constraints that the platform enforces with IllegalArgumentException: SetMaxSelectionLimit accepts 1–100, SetMimeTypes accepts only image/video MIME types, and SetThemeNightMode accepts only the managed equivalents of UNDEFINED, NO, and YES (not every UI_MODE_NIGHT_* constant). Please document these accepted domains.

[jonathanpeppers]

@dalexsoto Addressed the requested platform-enforced domains from the AOSP EmbeddedPhotoPickerFeatureInfo.Builder source: selection limit 1-100, image/video-only MIME types, and the three supported managed night-mode constants.

[jonathanpeppers]

@dalexsoto review

[Copilot]

Pull request overview

This PR replaces a subset of To be added. XML documentation placeholders in Android.Widget.PhotoPicker with source-backed descriptions for the embedded Photo Picker surface/session, client callbacks, provider factory creation, feature-info builder configuration, and Parcelable behavior.

Changes:

• Documented the embedded session SurfacePackage property and clarified how callers attach it.
• Filled in parameter/return documentation for embedded client callbacks and provider factory creation.
• Added documentation for EmbeddedPhotoPickerFeatureInfo’s CREATOR, DescribeContents, and WriteToParcel, plus multiple EmbeddedPhotoPickerFeatureInfo.Builder configuration APIs.

Reviewed changes

Copilot reviewed 5 out of 5 changed files in this pull request and generated 1 comment.

Show a summary per file

File	Description
docs/xml/Android.Widget.PhotoPicker/IEmbeddedPhotoPickerSession.xml	Documents the embedded session surface package returned to hosts.
docs/xml/Android.Widget.PhotoPicker/IEmbeddedPhotoPickerClient.xml	Adds parameter docs for session error/open and URI permission grant/revoke callbacks.
docs/xml/Android.Widget.PhotoPicker/EmbeddedPhotoPickerProviderFactory.xml	Documents provider creation parameter and return value.
docs/xml/Android.Widget.PhotoPicker/EmbeddedPhotoPickerFeatureInfo+Builder.xml	Documents builder configuration methods and build return value.
docs/xml/Android.Widget.PhotoPicker/EmbeddedPhotoPickerFeatureInfo.xml	Documents Parcelable creator and parceling-related methods.

---

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

[dalexsoto]

The platform-enforced builder input domains are now documented; no blocking issues remain.