From 9e05e05d01abd79831312911a1146d4cf2b5f3d2 Mon Sep 17 00:00:00 2001 From: Alexandra Date: Thu, 12 Mar 2026 16:31:53 +0100 Subject: [PATCH 1/2] large files work both on ios and android --- src/field/offline-use/index.md | 2 +- src/gis/settingup_background_map/index.md | 15 +++++++-------- src/manage/project/index.md | 2 +- src/manage/selective_sync/index.md | 2 +- src/migrate/qfield/index.md | 2 +- 5 files changed, 11 insertions(+), 12 deletions(-) diff --git a/src/field/offline-use/index.md b/src/field/offline-use/index.md index bb991a50..fe670a90 100644 --- a/src/field/offline-use/index.md +++ b/src/field/offline-use/index.md @@ -34,7 +34,7 @@ In general, layers that do not work offline are: #### Offline background maps Online background maps have to be prepared for offline use by generating **vector or raster tiles**. Detailed steps on how to do it can be found in [Background Maps](../../gis/settingup_background_map/). -Vector and raster tiles can be packaged in the project. However, as these files can be rather large, it might be impractical to synchronise them trough . [How to work with very large files](../../gis/settingup_background_map/#how-to-work-with-very-large-files-android) will show you how to get them in your mobile device. +Vector and raster tiles can be packaged in the project. However, as these files can be rather large, it might be impractical to synchronise them trough . [How to work with very large files](../../gis/settingup_background_map/#how-to-work-with-very-large-files) will show you how to get them in your mobile device. #### Offline PostGIS layers If you use online PostGIS layers in your project and need to do an offline survey in the field, we recommend using [DB Sync](../../dev/dbsync/). DB Sync helps synchronising your PostGIS database and GeoPackage layers that can be edited offline using . diff --git a/src/gis/settingup_background_map/index.md b/src/gis/settingup_background_map/index.md index c1ea597a..b41208e4 100644 --- a/src/gis/settingup_background_map/index.md +++ b/src/gis/settingup_background_map/index.md @@ -76,7 +76,7 @@ To generate an offline copy of the aerial imagery from your map view extent: ![QGIS generate XYZ tiles MBTiles settings](./qgis_xyz_gen_mbtiles2.jpg "QGIS generate XYZ tiles MBTiles settings") :::warning -Depending on the size of your study area and the zoom level, the output file can be very large. See how to [work with large files](#how-to-work-with-very-large-files-android) in . +Depending on the size of your study area and the zoom level, the output file can be very large. See how to [work with large files](#how-to-work-with-very-large-files) in . ::: ## Vector tiles @@ -152,7 +152,7 @@ Vector tiles for offline use can be downloaded easily using . ![QGIS download vector tiles dialog](./qgis-vector-tiles-set-extent.jpg "QGIS download vector tiles dialog") - MBTiles can be stored in your [ project folder](../../manage/project/#mergin-maps-project-folder) and synchronised to along with your project. If you find it impractical to synchronise them or if you want to use the same file in multiple projects, follow the steps on [How to work with large files](#how-to-work-with-very-large-files-android) in . + MBTiles can be stored in your [ project folder](../../manage/project/#mergin-maps-project-folder) and synchronised to along with your project. If you find it impractical to synchronise them or if you want to use the same file in multiple projects, follow the steps on [How to work with large files](#how-to-work-with-very-large-files) in . 4. Click **Run**. After the vector tiles are generated and downloaded successfully, the MBTiles file will be added to the **Layers** panel. You may close the algorithm dialog window. @@ -163,8 +163,7 @@ Before taking your offline tiles to the field, we recommend checking in +## How to work with very large files Raster and vector tiles generated for offline use can be relatively large files, especially when using high resolution data or a large area of interest. It may be impractical to synchronise these large files through or to have duplicate copies if they are used in multiple projects. @@ -178,11 +177,11 @@ QGIS uses relative paths to load the data. If your project ![File folder storing large data](./bm-folder-large-files.jpg "File folder storing large data") 2. Open your project in QGIS. Load the files from the `_rasters` folder to the project. Save and sync. -3. Connect your mobile device to the computer and copy the `_rasters` folder to the app's project folder `Internal storage/Android/data/uk.co.lutraconsulting/files/projects`. - - See [Manual data transfer (Android)](../../manage/missing-data/#manual-data-transfer-android) for detailed steps. +3. Connect your mobile device to the computer and copy the `_rasters` folder to the app's project folder + - on Android, follow the steps described in [Manual data transfer (Android)](../../manage/missing-data/#manual-data-transfer-android) + - on iOS, follow the steps described in [Manual data transfer (iOS)](../../manage/missing-data/#manual-data-transfer-ios) -4. Use the project in as usual. +4. Use the project in the as usual. :::tip Files from the folder can be loaded into multiple projects. diff --git a/src/manage/project/index.md b/src/manage/project/index.md index 7bb28f04..9e1de7d7 100644 --- a/src/manage/project/index.md +++ b/src/manage/project/index.md @@ -91,5 +91,5 @@ It is best to store all survey layers and relevant datasets in the project's fol :::tip It is possible to use files that are stored in other folders in . However, these folders have to be [manually transferred](../missing-data/#manual-data-transfer-android). -This can be useful when working with [very large datasets](../../gis/settingup_background_map/#how-to-work-with-very-large-files-android) such as large rasters or background maps. +This can be useful when working with [very large datasets](../../gis/settingup_background_map/#how-to-work-with-very-large-files) such as large rasters or background maps. ::: diff --git a/src/manage/selective_sync/index.md b/src/manage/selective_sync/index.md index 61c541bf..4cc974d4 100644 --- a/src/manage/selective_sync/index.md +++ b/src/manage/selective_sync/index.md @@ -9,7 +9,7 @@ Selective sync feature adds a possibility to not download specified files on oth Selective sync is useful mainly when a project contains a lot of data (for example photos) and these data do not necessarily need to be stored on all devices. Another advantage is a significant reduction of synchronisation time. :::tip -If you want to use large files (e.g. background maps) in your project without synchronisation, see [How to work with very large files](../../gis/settingup_background_map/#how-to-work-with-very-large-files-android). +If you want to use large files (e.g. background maps) in your project without synchronisation, see [How to work with very large files](../../gis/settingup_background_map/#how-to-work-with-very-large-files). ::: See the example in the picture below. Two surveyors Jim and Susan are capturing features in the field. When it comes to synchronisation, Jim hits the [arrow icon](../plugin/) to synchronise his changes. Features together with photos are now stored on the server. When Susan synchronises the project, synchronisation first downloads Jim's changes (including photos) and after that uploads Susan's changes to the server. However, selective sync can exclude photos from being downloaded. diff --git a/src/migrate/qfield/index.md b/src/migrate/qfield/index.md index 2570bbab..dce207eb 100644 --- a/src/migrate/qfield/index.md +++ b/src/migrate/qfield/index.md @@ -119,7 +119,7 @@ In our blog or to have duplicate copies if they are used in multiple projects. -:::tip +:::tip If you do not need to use your background maps offline, consider creating a WMS or WMTS server for online use. ::: -QGIS uses relative paths to load the data. If your project refers to files located in another folder, this project can be loaded just fine on another computer or in - if the folder with the files can be found in its expected location. +QGIS uses relative paths to load the data. If your project refers to files located in another folder, this project can be loaded just fine on another computer or in - if the folder with the files can be found in its expected location. Note that multiple projects can refer to the same files. 1. On your computer, create a folder that will contain the large datasets (here: `_rasters`). It should be located in the same directory as your projects. ![File folder storing large data](./bm-folder-large-files.jpg "File folder storing large data") @@ -183,10 +183,6 @@ QGIS uses relative paths to load the data. If your project 4. Use the project in the as usual. -:::tip -Files from the folder can be loaded into multiple projects. -::: - -:::warning -Files located in the another folder are not synchronised. This saves your storage on . However, if you want to update or modify these files, you have to connect the mobile device to your computer and do it manually. +:::warning These files are not synchronised +Files that are not located directly in the project folder are not synchronised. This saves your storage on . However, if you want to update or modify these files, you have to connect the mobile device to your computer and do it manually. :::