Skip to content
This repository was archived by the owner on Mar 4, 2023. It is now read-only.

Commit 97c3c61

Browse files
authored
Create README.md
1 parent 182a6e9 commit 97c3c61

File tree

1 file changed

+6
-2
lines changed

1 file changed

+6
-2
lines changed

README.md

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -26,7 +26,7 @@ Utils for easy c++ and qml integration of common android features
2626
## Installation
2727
The package is providet as qpm package, [`de.skycoder42.androidutils`](https://www.qpm.io/packages/de.skycoder42.androidutils/index.html). To install:
2828

29-
1. Install qpm (See [GitHub - Installing](https://github.com/Cutehacks/qpm/blob/master/README.md#installing))
29+
1. Install qpm (See [GitHub - Installing](https://github.com/Cutehacks/qpm/blob/master/README.md#installing), for **windows** see below)
3030
2. In your projects root directory, run `qpm install de.skycoder42.androidutils`
3131
3. Include qpm to your project by adding `include(vendor/vendor.pri)` to your `.pro` file
3232
4. Add the line `apply from: "androidutils.gradle"` at the very bottom of your `build.gradle` file
@@ -35,6 +35,10 @@ The package is providet as qpm package, [`de.skycoder42.androidutils`](https://w
3535

3636
Check their [GitHub - Usage for App Developers](https://github.com/Cutehacks/qpm/blob/master/README.md#usage-for-app-developers) to learn more about qpm.
3737

38+
**Important for Windows users:** QPM Version *0.10.0* (the one you can download on the website) is currently broken on windows! It's already fixed in master, but not released yet. Until a newer versions gets released, you can download the latest dev build from here:
39+
- https://storage.googleapis.com/www.qpm.io/download/latest/windows_amd64/qpm.exe
40+
- https://storage.googleapis.com/www.qpm.io/download/latest/windows_386/qpm.exe
41+
3842
## Usage
3943
Just include/import (`import de.skycoder42.androidutils 1.0`) the class and use the methods. All the setup and registrations are done automatically.
4044

@@ -53,4 +57,4 @@ In that case, make shure you initialize androidnative.pri by adding `AndroidNati
5357
This variable should contain the root directory of qpm, i.e. the `vendor` directory. By default (if you don't set the variable), it is set to `$$_PRO_FILE_PWD_/vendor`. If your qpm vendor folder is not located in the same directory as your pro file, set this variable to the **absolute** path of your vendor folder. If you use the `_PRO_FILE_PWD_`, you can simply make the path relative to this directory, e.g. `QPM_ROOT = $$_PRO_FILE_PWD_/../vendor`.
5458

5559
## Android URI permissions
56-
To open generic content uris, you need to get permissions for those. For local files, this are the normal read/write external storage permissions. For other content, i.e. from Dropbox, those permissions are granted for every uri. Those permissions will stay as long as your application is running, but if you want to access them later, e.g. after a restart, you need to persist the permissions. The FileChooser can do this for you, by setting the required `chooserFlags`. If you get Security exceptions when trying to read/write a file, this is what you need to adjust.
60+
To open generic content uris, you need to get permissions for those. For local files, this are the normal read/write external storage permissions. For other content, i.e. from Dropbox, those permissions are granted for every uri. Those permissions will stay as long as your application is running, but if you want to access them later, e.g. after a restart, you need to persist the permissions. The FileChooser can do this for you, by setting the required `chooserFlags`. If you get Security exceptions when trying to read/write a file, this is what you need to adjust.

0 commit comments

Comments
 (0)