https://github.com/authpass/macos_secure_bookmarks

Flutter plugin to create secure bookmarks to keep access to files in sandboxed apps.
https://github.com/authpass/macos_secure_bookmarks

Last synced: about 1 month ago
JSON representation

Flutter plugin to create secure bookmarks to keep access to files in sandboxed apps.

• Host: GitHub
• URL: https://github.com/authpass/macos_secure_bookmarks
• Owner: authpass
• License: apache-2.0
• Created: 2019-09-14T10:52:20.000Z (over 5 years ago)
• Default Branch: master
• Last Pushed: 2022-09-17T11:37:30.000Z (over 2 years ago)
• Last Synced: 2025-04-24T05:46:10.967Z (about 1 month ago)
• Language: Dart
• Size: 11.2 MB
• Stars: 15
• Watchers: 2
• Forks: 12
• Open Issues: 9
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# macos_secure_bookmarks

[![Pub](https://img.shields.io/pub/v/macos_secure_bookmarks?color=green)](https://pub.dev/packages/macos_secure_bookmarks)

Flutter plugin to create secure bookmarks to keep access to files in sandboxed apps.

## Usage

* Check the [documentation on security-scoped bookmarks](https://developer.apple.com/library/archive/documentation/Security/Conceptual/AppSandboxDesignGuide/AppSandboxInDepth/AppSandboxInDepth.html#//apple_ref/doc/uid/TP40011183-CH3-SW16)

* Make sure to [enable the necessary entitlements](https://developer.apple.com/library/archive/documentation/Miscellaneous/Reference/EntitlementKeyReference/Chapters/EnablingAppSandbox.html#//apple_ref/doc/uid/TP40011195-CH4-SW18)

    * com.apple.security.files.bookmarks.app-scope

### Creating Security Scoped Bookmarks

```dart

// First let the user choose a file, e.g. using the file chooser plugin.

showOpenPanel((result, files) {

  if (result != FileChooserResult.ok || files.isEmpty) {

    return;

  }

  

  // Now create a security scoped bookmark

  final secureBookmarks = SecureBookmarks();

  final bookmark = await secureBookmarks.bookmark(File(_file));

  

  // Now store the bookmark somewhere for later invocations

});

```

### Resolving and accessing bookmarks

```dart

// resolve bookmark from persistet 'bookmark' string from earlier

final resolvedFile = await _secureBookmarks.resolveBookmark(_bookmark);

// resolved is now a File object, but before accessing it, call:

await startAccessingSecurityScopedResource(resolvedFile);

// now read/write the file

// and later give up access.

await stopAccessingSecurityScopedResource(resolvedFile);

```