Interface Offline Files.
Interface Offline Files.
← Tut las guidas Bubble Native

Xodera Plugins · Bubble Native

Xodera Offline Files Native

Mantgna i atachaments dal rapport e ils files tschernids sin il dispositiv, restauria els pli tard e permetta al dovrar da cundivider ina copia selecziunada.

Public beta guides · Haptics instructions are in its Bubble listing

Public beta offer: free Bubble install · 7-day card trial, then US$1.50/month per plugin/project.

Documentaziun controllada ils 6 da november 2026

Exemplars pratics

Prepara pliras atachaments locals avant da trametter in rapport

In formular sto mussar quels files èn tschernids e permetter al dovrar da mantener ina copia gestida avant mintga invio al nìvol.

`accepted_mime_types_json = your allowed MIME list`; `multiple = yes`; definescha `max_files`, `max_file_bytes` e in conto/rapport `document_context`.

Pick files → controlla ils nums e las grondezzas tschernidas → Save selection locally. Tes formular conserva ils IDs da datotecas resultants enfin ch'il flus Submit separat chargia las datotecas approvadas.

Dovra `selection_count`, `file_names`, `file_sizes` e `saved_file_ids` per mussar la glista da controlla. Ina copia administrada e memorisada conserva l'original dal clamader.

In selector annullà n’è betg in rapport tramess. Sin `files_error`, mantegna ils ID locals gia acceptads e mussa `error_code`; na crees mai ina agiunta cloud da in URI local sulettamain.

Ils files restan sin quest apparat enfin che vegnan partids u chargiads separadamain.

Conserva l’output d’un editur da fotos u d’in registrader per l’utilisaziun futura.

In file local generà po star en ina posiziun temporara; l’app ha basegn d’ina copia gestida explicita.

`source_uri = the local output of a separately accepted editor/recorder`; lega sia vera `display_name` e `mime_type`; duvrar il `document_context` dal medem proprietari.

Load local source → inspeccionar metadata → Save selection locally. Memorisescha l’ID dal file returnà mo en il dispositiv/context correspundent, suenter Restore saved file cun quel ID exact cura necessari.

Consume `file_id`, `local_uri`, `size_bytes` e `is_saved_locally`; duvrar `file_restored` per distinguer ina restauraziun cumpletta da simplamain ina dumonda.

Refusa in URL HTTP remote sco funtauna locala. Sche ina funtauna è svanida u la restauraziun fallescha, mussa `error_code` e preserva il registr da l’app original per la recuperaziun.

Ils files restan sin quest apparat enfin che vegnan partids u chargiads separadamain.

Permetta ad in utilisader da cundivider ina ricevuta locala generada da l’app u in export.

L’app duvria transmetter in file local selecziunà al panel da cundivisiun dal dispositiv, enstagl da crear in URL public.

`selected_file_id = the exact managed copy chosen from your app’s saved-file list`; sia num e MIME descrivan il file local real.

List saved files → Restore saved file → Share selected file cura che l'utilisader clicca sin Share. Conserva la copia memorisada enfin ch'el tscherna explicitamain Delete saved copy.

Utilisescha `share_status` e `share_sheet_closed` per actualisar l’interfatscha d’utilisader suenter la serrada dal panel. Mantegna l’ID dal file per ina autra cundivisiun deliberada.

In panel da cundivisiun serrà n’è betg la prova che in e‑mail/messadi è vegnì livrà. Tratta la annullaziun e `files_error` senza rapportar success al destinatar.

Ils files restan sin quest apparat enfin che vegnan partids u chargiads separadamain.

Tge che funcziuna ussa

Public beta. Use the documented controls and actions; test supported formats, permissions and device behavior in your own native app. Browser preview does not validate native device output.

Crear il flus da lavur

Utilisescha las acziuns beta disponiblas sutvart e testa il resultat sin tes apparats mira.

Quests exempels dovran endataziuns da l'app sco Lesson, Message ed Order. Remplazza quellas cun tes agens tips da datas e nums d'elements. Remplazza las adressas da medias d'exempel cun tias atgnas datotecas.

  1. Definescha document_context = Current User's unique id, u in valur stabil per il conto e rapport. Tscherna accepted_mime_types_json, max_files e max_file_bytes.

  2. Execüta Pick files, u utilisescha Load local source per in file legibel produs da Photo Editor u Recorder. Suenter selection_changed, legia las listas da files correspundentas; Select picked file tscherna in index.

  3. Execüta Save selection locally. Suenter files_saved, mantgna saved_file_ids en il register local d'atachs da tia app. List saved files mussa las copias salvadas; Restore saved file avra l'ID salvà selecziunà.

  4. Share selected file avra il menu da cundivisiun dal sistem. share_sheet_closed signifitga mo che il menu è serrà. Delete saved copy dovra l'ID selecziunà e confirm=yes.

Diagramma dal flus da lavur — betg ina captura d’app

Configurar ina giada

Creescha u tscherna tes project d'app Bubble en BestPlugins → Dashboard → Plugins. Tscherna Xodera Offline Files Native, copia sia clav, suenter avra Bubble → Plugins → Xodera Offline Files Native e incolla ella en licensing_api_key. Salva ina giada; suenter utilisescha las acziuns sutvart. Mintga plugin en mintga project ha sia propria clav.

Utilisescha ina app nativa cun access a ils files tschernids. Definescha in document_context stabil per il conto u rapport per che ses files salvads restan correctamain ragruppads.

Configurar ina giada
  1. Creescha u tscherna tes project d'app Bubble en BestPlugins → Dashboard → Plugins.
  2. Tscherna quest plugin e copia sia clav dal project.
  3. Open Bubble → Plugins → this plugin. Paste its project key into licensing_api_key and save.
  4. Agiunta l'element, tscherna tias datas d'app e construescha il flus da lavur sutvart.
  5. In the dashboard, review and confirm the 7-day card trial for this plugin. It then costs US$1.50/month per app project, including development and production. Cancel before the trial ends to avoid the first charge.
Installaziun e abonnament

For Audio Player, Video Player, Photo Editor, Audio Recorder, Files Kit and Haptics: free Bubble installation, a 7-day trial with a card, then US$1.50 per month per plugin and app project. Development and production are included, with no operation cap. File-size and feature limits still apply. Review billing and cancellation before confirming. Other plugins remain unavailable for purchase.

Memorisar il resultat en tia app

Exempel LocalAttachment: proprietari, document_context, ID dal file salvà, display_name, mime_type e size_bytes. Quest ID funcziuna mo sin il medem dispositiv e per il medem conto u raport. Per in atachament online, incaricha il file cun in flus da lavur separat e salva la referenza dal file online returnà.

Falliment, annullar e restaurar

In selector annullà returna operation_cancelled; el na trametta betg il formular. Durant native_pending=yes, spetga che il selector da file u il menu da cundivisiun sa serri avant d'avrir in auter. Clear session stizza la selecziun actuala ma mantgna las copias salvadas. Sche in file manca, permetta al dovrar da l'eleger anc ina giada.

Capacitads e lims

Tscherna files 1–20 tut ensemen. Limita per file: 1 byte–256 MiB, cun ina limita pli bass se ti tschernas. Ils filtars per tip da file na controllan betg ils files per virus. IDs e percurs da file dal dispositiv na funcziunan betg sco colliaziuns per telechargiar en il nìvol. Copias localas na èn betg archiv encriptà e pon vegnir perdidas sch'i vegn stizzà las datas da l'app.

Configuraziuns, acziuns e resultats

Utilisescha quests numens en Bubble. Funcziuns planisadas èn marcadas separadamain.

Configuraziuns beta disponiblas

Configuraziun da l'element

source_uri · textdisplay_name · textmime_type · textdocument_context · textselected_file_id · textaccepted_mime_types_json · textmultiple · yes_nocopy_to_cache · yes_nomax_files · numbermax_file_bytes · numberis_active · yes_nodisabled · yes_noshow_controls · yes_nolanguage · textui_text_json · texttitle · text

Stadis

status · textis_busy · yes_nonative_pending · yes_nooperation · textselection_count · numberselected_index · numberfile_id · textlocal_uri · textdisplay_name · textmime_type · textmime_source · textsize_bytes · numberis_saved_locally · yes_nofile_ids · text (lista)file_uris · text (lista)file_names · text (lista)file_mime_types · text (lista)file_sizes · number (lista)files_json · textsaved_count · numbersaved_file_ids · text (lista)saved_file_uris · text (lista)saved_file_names · text (lista)saved_file_mime_types · text (lista)saved_file_sizes · number (lista)saved_files_json · textinvalid_saved_count · numbershare_status · texterror_code · text

Eveniments

selection_changedfiles_savedlist_loadedfile_restoredfile_deletedshare_sheet_closedoperation_cancelledfiles_error

Acziuns e lur inputs

Pick filesLoad local sourceSelect picked fileSave selection locallyList saved filesRestore saved fileDelete saved copyShare selected fileCancel operationClear session
Configuraziun da l'element · 16
source_uritext · Standard: ""
Valur d'exempelfile:///app-cache/report.pdf
Exempel Bubble expressiunPhoto Editor's output_uri
Posiziun da file legibla sin quest apparat, returnada dal selector u dad in auter plugin.
display_nametext · Standard: ""
Valur d'exempelreport-photo.jpg
Exempel Bubble expressiunSelected Attachment's display_name
Utilisescha il valur dal registr da l'interpresa actual; validescha el cun ils limits sutvart.
mime_typetext · Standard: ""
Valur d'exempelimage/jpeg
Exempel Bubble expressiunPhoto Editor's output_mime
Utilisescha il valur dal registr da l'interpresa actual; validescha el cun ils limits sutvart.
document_contexttext · Standard: "default"
Valur d'exempel<current-user-id>
Exempel Bubble expressiunCurrent User's unique id
Valur stabla per quest conto u questa endataziun. Dovra la medema valur per restaurar sias datotecas u ses sbozs memorisads.
selected_file_idtext · Standard: ""
Valur d'exempel<returned saved file ID>
Exempel Bubble expressiunSelected LocalAttachment's local_file_id
Utilisescha il valur dal registr da l'interpresa actual; validescha el cun ils limits sutvart.
accepted_mime_types_jsontext · Standard: "[\"*/*\"]"
Valur d'exempel["image/*","application/pdf"]
Exempel Bubble expressiunReport Settings' accepted_mime_types_json
Utilisescha il valur dal registr da l'interpresa actual; validescha el cun ils limits sutvart.
multipleyes_no · Standard: false
Valur d'exempelyes
Exempel Bubble expressiunReport Settings' allow_multiple_attachments
Utilisescha il valur dal registr da l'interpresa actual; validescha el cun ils limits sutvart.
copy_to_cacheyes_no · Standard: true
Valur d'exempelyes
Exempel Bubble expressiunReport Settings' copy_to_cache
Utilisescha il valur dal registr da l'interpresa actual; validescha el cun ils limits sutvart.
max_filesnumber · Standard: 20
Valur d'exempel5
Exempel Bubble expressiunReport Settings' attachment_limit
Utilisescha il valur dal registr da l'interpresa actual; validescha el cun ils limits sutvart.
max_file_bytesnumber · Standard: 268435456
Valur d'exempel10485760
Exempel Bubble expressiunReport Settings' max_attachment_bytes
Utilisescha il valur dal registr da l'interpresa actual; validescha el cun ils limits sutvart.
is_activeyes_no · Standard: true
Valur d'exempelyes
Exempel Bubble expressiunGuideHost's view_is_active (your yes/no custom state)
Definiescha yes durant che questa vista è averta. Definiescha no cura che ti bandunas ella, per che la reproducziun u il lavur actual possia sa fermar.
disabledyes_no · Standard: false
Valur d'exempelno
Exempel Bubble expressiunGuideHost's is_busy (your yes/no custom state)
Deactiva l'element cura che tia app è occupada u che questa acziun è betg disponibla.
show_controlsyes_no · Standard: true
Valur d'exempelyes
Exempel Bubble expressiunApp Settings' show_editor_controls
Mussar u zuppentar ils controlls integrads.
languagetext · Standard: "auto"
Valur d'exempeluk
Exempel Bubble expressiunCurrent User's preferred_language
Definiescha language=auto per suandar la lingua da l'apparat u dal navigatur, sch'ella è sustegnida. Endatescha in code da lingua sustegnì per tscherner quella explicitamain.
ui_text_jsontext · Standard: ""
Valur d'exempel{}
Exempel Bubble expressiunApp Settings' player_labels_json (supported keys only)
JSON facultativ cun etichettas da buttun sustegnidas. Lascha vid per duvrar il text integrà.
titletext · Standard: ""
Valur d'exempelLesson 4 — review
Exempel Bubble expressiunSelected Lesson's name
Text visibel da l'app; vid duvrar la copia integràda localisada là nua ch'ella è sustegnida. Naginas credenzials.
Acziuns e lur inputs · 10
Pick files

Nagins parameters d'acziun

Load local source
source_uritext · Standard: —
Valur d'exempelfile:///app-cache/report.pdf
Exempel Bubble expressiunPhoto Editor's output_uri
Posiziun da file legibla sin quest apparat, returnada dal selector u dad in auter plugin.
display_nametext · Standard: —
Valur d'exempelreport-photo.jpg
Exempel Bubble expressiunSelected Attachment's display_name
Utilisescha il valur dal registr da l'interpresa actual; validescha el cun ils limits sutvart.
mime_typetext · Standard: —
Valur d'exempelimage/jpeg
Exempel Bubble expressiunPhoto Editor's output_mime
Utilisescha il valur dal registr da l'interpresa actual; validescha el cun ils limits sutvart.
Select picked file
indexnumber · Standard: —
Valur d'exempel0
Exempel Bubble expressiunSelected row's current_source_index
Utilisescha il valur dal registr da l'interpresa actual; validescha el cun ils limits sutvart.
Save selection locally

Nagins parameters d'acziun

List saved files

Nagins parameters d'acziun

Restore saved file
file_idtext · Standard: —
Valur d'exempel<returned saved file ID>
Exempel Bubble expressiunSelected LocalAttachment's local_file_id
Utilisescha il valur dal registr da l'interpresa actual; validescha el cun ils limits sutvart.
Delete saved copy
file_idtext · Standard: —
Valur d'exempel<returned saved file ID>
Exempel Bubble expressiunSelected LocalAttachment's local_file_id
Utilisescha il valur dal registr da l'interpresa actual; validescha el cun ils limits sutvart.
confirmyes_no · Standard: —
Valur d'exempelyes — explicit confirmation only
Exempel Bubble expressiunConfirm Checkbox is checked
Utilisescha il valur dal registr da l'interpresa actual; validescha el cun ils limits sutvart.
Share selected file
dialog_titletext · Standard: —
Valur d'exempelShare attachment
Exempel Bubble expressiunSelected Report's share_title
Utilisescha il valur dal registr da l'interpresa actual; validescha el cun ils limits sutvart.
utitext · Standard: —
Valur d'exempel""
Exempel Bubble expressiunEmpty unless your iOS integration supplies a proven UTI
Utilisescha il valur dal registr da l'interpresa actual; validescha el cun ils limits sutvart.
Cancel operation

Nagins parameters d'acziun

Clear session

Nagins parameters d'acziun

Stadis e eveniments

Stadis

status · text

Resultat actual da questa acziun. Dovra l'eveniment correspundent che inditgescha la fin da l'acziun avant da memorisar il success.

is_busy · yes_no

Il lavur è anc en cors. Spetga avant da cumenzar ina nova acziun.

native_pending · yes_no

Il lavur è anc en cors. Spetga avant da cumenzar ina nova acziun.

operation · text

Valur actual per l'element selecziunà. Legia el suenter l'eveniment relatà.

selection_count · number

Valur actual per l'element selecziunà. Legia el suenter l'eveniment relatà.

selected_index · number

Valur actual per l'element selecziunà. Legia el suenter l'eveniment relatà.

file_id · text

Identificader per quest element u acziun. Mantegna el cun il registr da l'app correspundent. Utilisescha il medem identificader da dumonda cun reprovair in resultat incert.

local_uri · text

Posiziun dal datoteca sin quest apparat. Salva u incaricha il datoteca separadamain sch'igl è necessari da mantenerla online.

display_name · text

Valur actual per l'element selecziunà. Legia el suenter l'eveniment relatà.

mime_type · text

Valur actual per l'element selecziunà. Legia el suenter l'eveniment relatà.

mime_source · text

Valur actual per l'element selecziunà. Legia el suenter l'eveniment relatà.

size_bytes · number

Valur actual per l'element selecziunà. Legia el suenter l'eveniment relatà.

is_saved_locally · yes_no

Valur actual per l'element selecziunà. Legia el suenter l'eveniment relatà.

file_ids · text (lista)

Ina glista per ils files selecziunads. Elements cun il medem indice en las autras glistas da files fan referenza al medem file.

file_uris · text (lista)

Ina glista per ils files selecziunads. Elements cun il medem indice en las autras glistas da files fan referenza al medem file.

file_names · text (lista)

Ina glista per ils files selecziunads. Elements cun il medem indice en las autras glistas da files fan referenza al medem file.

file_mime_types · text (lista)

Ina glista per ils files selecziunads. Elements cun il medem indice en las autras glistas da files fan referenza al medem file.

file_sizes · number (lista)

Ina glista per ils files selecziunads. Elements cun il medem indice en las autras glistas da files fan referenza al medem file.

files_json · text

Valur actual per l'element selecziunà. Legia el suenter l'eveniment relatà.

saved_count · number

Valur actual per l'element selecziunà. Legia el suenter l'eveniment relatà.

saved_file_ids · text (lista)

Ina glista per ils files selecziunads. Elements cun il medem indice en las autras glistas da files fan referenza al medem file.

saved_file_uris · text (lista)

Ina glista per ils files selecziunads. Elements cun il medem indice en las autras glistas da files fan referenza al medem file.

saved_file_names · text (lista)

Ina glista per ils files selecziunads. Elements cun il medem indice en las autras glistas da files fan referenza al medem file.

saved_file_mime_types · text (lista)

Ina glista per ils files selecziunads. Elements cun il medem indice en las autras glistas da files fan referenza al medem file.

saved_file_sizes · number (lista)

Ina glista per ils files selecziunads. Elements cun il medem indice en las autras glistas da files fan referenza al medem file.

saved_files_json · text

Valur actual per l'element selecziunà. Legia el suenter l'eveniment relatà.

invalid_saved_count · number

Valur actual per l'element selecziunà. Legia el suenter l'eveniment relatà.

share_status · text

Resultat actual da questa acziun. Dovra l'eveniment correspundent che inditgescha la fin da l'acziun avant da memorisar il success.

error_code · text

Informaziuns d'error per l'ultima acziun. Mussar in messadi d'agid e porscher il reprovà pertinent.

Eveniments

selection_changed

Sch'quest event succeda, legia ils stadi relatads da l'istess element.

files_saved

Sch'quest event succeda, legia ils stadi relatads da l'istess element.

list_loaded

Sch'quest event succeda, legia ils stadi relatads da l'istess element.

file_restored

Sch'quest event succeda, legia ils stadi relatads da l'istess element.

file_deleted

Sch'quest event succeda, legia ils stadi relatads da l'istess element.

share_sheet_closed

Sch'quest event succeda, legia ils stadi relatads da l'istess element.

operation_cancelled

Sch'quest event succeda, legia ils stadi relatads da l'istess element.

files_error

Sch'quest event succeda, legia ils stadi relatads da l'istess element.

Dumondas che ils sviluppaders fan

Signifitga Share “tramess”?

Na. Il sistem operativ na furnescha qua nagina conferma fidabla che la datoteca è arrivada tar il destinatar. Mussa «panel da cundivisiun serrà».

Co funcziuna l'abunament?

For Audio Player, Video Player, Photo Editor, Audio Recorder, Files Kit and Haptics: free Bubble installation, a 7-day trial with a card, then US$1.50 per month per plugin and app project. Development and production are included, with no operation cap. File-size and feature limits still apply. Review billing and cancellation before confirming. Other plugins remain unavailable for purchase.

Guidas colliadas

Per agid, indichescha nus tge plugin e tge apparat ti dovras, l'acziun che ti has empruvà e tge succedì. Dovra in exempel senza datas persunalas. Mai cundivida tia clav ni tes files privats.