@nacrejs/photos
v0.0.1
Published
Nacre 的相册能力:从相册选图、把图片存进相册。装了才有 PHPickerViewController 和 PHPhotoLibrary
Readme
@nacrejs/photos
A capability package for Nacre, a JavaScript runtime for iOS apps: picking images from the photo library and saving images to it. It provides PHPickerViewController, PHPhotoLibrary and the classes around them. The app has it only if the project installs this package.
Picking images needs no permission, but the usage description is required as soon as the package is installed.
Install
In a Nacre project, three steps.
1. Install the package.
npm install @nacrejs/photos2. Bring in its types at the top of the entry file.
/// <reference types="@nacrejs/types" />
/// <reference types="@nacrejs/photos" />3. Write its usage description in nacre.config.json.
{
"ios": {
"infoPlist": {
"NSPhotoLibraryAddUsageDescription": "Used to save images to your photo library"
}
}
}NSPhotoLibraryAddUsageDescription is the sentence iOS shows the user when the app first asks to add images to the photo library. Only you can write it, so the package doesn't ship one. If it's missing, nacre generate stops with an error that names the key. See Writing usage descriptions.
Effect: after you regenerate ios/ and rebuild, the app includes this capability, and typeof PHPickerViewController !== 'undefined' is true.
Without the package, its classes don't exist: reading one throws ReferenceError, and type checking reports it first.
For how to use it, see Photo library. For all capability packages, see Core and capability packages.
License
FSL-1.1-MIT, see LICENSE.md.
