Aller au contenu

QField Storage Access

Vous trouverez ci-dessous des instructions spécifiques à votre système d'exploitation sur la manière d'accéder aux projets de manipulation ainsi qu'aux ensembles de données individuels dans QField.

Android

Note

Note aux utilisateurs préexistants de QField : pour des raisons de sécurité, Google a depuis novembre 2021   un nouvel ensemble de règles d'accès au stockage qui interdit à la plupart des applications d'accéder directement aux fichiers dans la plupart des emplacements des stockages internes et externes d'un appareil. Pour travailler dans ce nouveau cadre, QField doit importer des projets et des ensembles de données dans l'emplacement de stockage spécifié par Google dans lequel QField a un accès illimité en lecture et en écriture. Les instructions ci-dessous devraient guider la migration des utilisateurs vers le nouveau paradigme.

Ouverture de projets et de jeux de données

QField peut ouvrir des projets et des ensembles de données de trois façons :

  • en important un dossier de projet ;
  • en important un fichier de projet compressé ; et
  • en important un ou plusieurs jeux de données individuels.

QField import actions
QField import actions

These actions are available via the dropdown action menu in the project/dataset picker‘s plus button, which can be accessed by clicking on the ‘Open local files’ button located in QField‘s welcome screen.

Importing a project folder

When importing a project through the "Import project from folder" action, users will be asked to grant permission for QField to read the content of a given folder on the device’s storage via a system folder picker. When the folder is selected, QField copies the folder content (including its sub-folders) into its ‘Imported projects’ location. Users can then open and interact with the project from there.

Re-importing a given folder through the drop-down menu action will overwrite preexisting projects given an identical folder name. That allows users to be able to update projects.

Note

Feature editing, addition, and deletion will be saved into the imported project’s datasets, not in the original folder selected during the import process. See sections below on how to send/export edited projects and datasets.

Importing a compressed project

Projects can be imported into QField by being provided a project compressed into a ZIP archive. When choosing the ‘Import project from ZIP’ action, users will be asked to select a ZIP file on their device‘s storage. QField will then decompress the file into its ‘Imported projects’ location. Users can then open and interact with the project from there.

This can greatly ease remote deployment of projects by being able to send a single file to users.

Importing individual dataset(s)

The ‘Import dataset(s)‘ action allows users to select one or more datasets via an Android system file picker. Upon selecting the datasets, QField will copy those into the ‘Imported datasets’ folder, where users can then open and modify their content.

Note

Users will have to ensure that all sidecar files are selected when importing datsets (e.g. a shapefile would require users to select the .shp, .shx, .dbf, .prj, and .cpg files).

Exporting modified projects and datasets

Once users modify imported projects and datasets, QField offer various means through which the content can be sent from and exported out of its system-protected files storage:

  • by exporting a project folder or an individual dataset;
  • by sending a compressed project folder to a {cloud, email, messenger, etc.} app;
  • by sending an individual dataset to a {cloud, email, messenger, etc.} app; and
  • by accessing imported content directly through USB cable.

QField export actions
QField export actions

These actions are available via the dropdown action menu attached to project folders and individual datasets list in the project/dataset picker, which can be accessed by clicking on the ‘Open local files‘ button located in QField’s welcome screen.

Exporting a project folder or an individual dataset

When choosing the ‘Export to folder‘ action, users will be asked to pick a location - using the Android system‘s folder picker activity - within which the content of a select project folder or individual dataset will be copied to.

This action can be used to copy the content of modified projects or datasets into a folder on the device that can be accessed by third-party synchronization apps such as Syncthing, or directly copy content into cloud accounts of providers that support Android‘s Scoped Storage directory provider (at the time of writing, only NextCloud app has such support).

Note

Exporting onto a folder will overwrite preexisting content.

Sending a compressed project folder

The ‘Send compressed folder to‘ action compresses the content of a selected folder into a ZIP archive. Users are then asked through which app on their device the resulting ZIP archive should be send through.

Users can compress and send whole projects by selecting root folders in QField‘s ‘Imported projects‘ directory, as well as send selective folders within project folders. This allows for users to narrow down the compressed files to e.g. a /DCIM subfolder.

Sending an individual dataset

Users can select the ‘Send to‘ action for individuald datasets, allowing for the sending of edited datasets directly to third party apps such as Gmail, Drive, Dropbox, Nextcloud, , etc.

Accessing imported content directly through USB cable

Imported projects and datasets can be accessed directly using a USB cable. The location is displayed in the top navigation bar of the project/dataset picker.

On most devices plugged into a computer via USB cable connection, the path will be <drive>:/Android/data/ch.opengis.qfield/files/. Users will find both the Imported Datasets and Imported Projects folders within which the imported projects and datasets will be located. Changes done to project content and datasets are saved in the files found in this location.