Mob.Files (mob v0.6.26)

System file picker. Opens the OS document picker (Files app on iOS, SAF on Android).

No permission required — the user explicitly selects files.

Results arrive as:

handle_info({:files, :picked,    items},   socket)
handle_info({:files, :cancelled},           socket)

Each item in items is:

%{path: "/tmp/mob_file_xxx.pdf", name: "report.pdf",
  mime: "application/pdf", size: 102400}

iOS: UIDocumentPickerViewController. Android: OpenMultipleDocuments.

"Open with" — files handed to us by another app

When the user opens a file into the app from elsewhere — e.g. a .livemd emailed to them and tapped — the OS launches (or foregrounds) the app with that file, provided the app declares the document type:

iOS: CFBundleDocumentTypes (+ an imported UTI) in Info.plist, and an application:openURL:options: handler that calls mob_handle_opened_url.
Android: an <intent-filter> for ACTION_VIEW / ACTION_SEND matching the mime type / extension; the Mob activity forwards it automatically.

Retrieve it with take_opened_document/0 from your root screen's mount/3.

Summary

Functions

pick(socket, opts \\ [])

take_opened_document()

Return the document another app asked us to open, or :none.

Functions

pick(socket, opts \\ [])

@spec pick(
  Mob.Socket.t(),
  keyword()
) :: Mob.Socket.t()

take_opened_document()

@spec take_opened_document() :: map() | :none

Return the document another app asked us to open, or :none.

Call once from your root screen's mount/3. The item has the same shape as pick/2 results:

%{path: "/tmp/demo.livemd", name: "demo.livemd",
  mime: "text/markdown", size: 1234}

The copied file lives in the app's tmp dir, so read or move it promptly. This call also registers the calling process to receive any file opened later while the app is already running, delivered as:

handle_info({:files, :opened, item}, socket)

Returns :none off-device or when nothing is pending. See the moduledoc for the platform manifest/Info.plist wiring "open with" requires.