File: environment.rst

package info (click to toggle)
python-briefcase 0.3.22-3
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 7,300 kB
  • sloc: python: 59,405; makefile: 57
file content (29 lines) | stat: -rw-r--r-- 1,016 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
===============================
Briefcase configuration options
===============================

Environment variables
=====================

``BRIEFCASE_HOME``
~~~~~~~~~~~~~~~~~~

When briefcase runs, it will download the support files, tools, and SDKs
necessary to support building and packaging apps. By default, it will store the
files in a platform-native cache folder:

* macOS: ``~/Library/Caches/org.beeware.briefcase``
* Windows: ``%LOCALAPPDATA%\BeeWare\briefcase\Cache``
* Linux: ``~/.cache/briefcase``

If you want to use a different folder to store the Briefcase resources, you can
define a ``BRIEFCASE_HOME`` environment variable.

There are three restrictions on this path specification:

1. The path must already exist. If it doesn't exist, you should create it manually.
2. It *must not* contain any spaces.
3. It *must not* be on a network drive.

The second two restrictions both exist because some of the tools that Briefcase
uses (in particular, the Android SDK) do not work in these locations.