File: README.source

package info (click to toggle)
keepassxc-browser 1.9.11%2Brepack1-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 4,260 kB
  • sloc: javascript: 9,941; sh: 44; makefile: 25
file content (60 lines) | stat: -rw-r--r-- 2,989 bytes parent folder | download | duplicates (3)
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
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
Files removed from upstream release
###################################

For the Debian package the following files are removed from the upstream
distribution (see Files-Excluded field in debian/copyright):

Upstream                                          | Replacement (file or packagename)
=======================================================================
.github/                                          | -
.tx/                                              | -
keepassxc-browser/background/nacl-util.min.js     | d/missing-sources/nacl-utils.js
keepassxc-browser/background/nacl.min.js          | node-tweetnacl
keepassxc-browser/bootstrap/bootstrap.min.css     | libjs-bootstrap5
keepassxc-browser/bootstrap/bootstrap.min.js      | libjs-bootstrap5
keepassxc-browser/common/browser-polyfill.min.js  | d/missing-sources/browser-polyfill.js
keepassxc-browser/fonts/fork-awesome.min.css      | fonts-fork-awesome
keepassxc-browser/fonts/forkawesome-webfont.woff2 | fonts-fork-awesome

NOTE: The above list is to be kept in sync with Files-Excluded in
debian/copyright! Rationale: The above list also documents replacements.

To download replacement files to debian/missing-sources/, adapt and run
debian/fetch-missing-sources.sh.

I decided to install human-readable files in the binary package and patch files
that include them instead.
Rationale: Since I am not experienced with web software and this package is
about to go through the NEW packages queue, I want to have as little
optimization as possible. In case of performance issues, or avoidable extra
maintainer effort, or if it simply turns out it is safe to include optimized
files, I am fine to change this later at any time.

Updating the package with new upstream release
##############################################
1. Use uscan to download the latest upstream release
2. Check in the repacked orig.tar.xz that no font files and no *.min.* files are
   included.
3. Update debian/changelog, build, etc.

Obtain extension key from Chromium extensions repository
########################################################
When the extension is executed in Chromium it uses the key 'key' in
keepassxc-browser/manifest.json to compute its identity it reports to KeePassXC,
which keeps an compiled-in whitelist for permitted IDs.

This key is generated once when an extension is uploaded to the Chromium
extensions repository for the first time and added automatically to
manifest.json.

We add this key to keepassxc-browser/manifest.json by
debian/patches/chromium-extension-key.patch. The value must be obtained manually
by the maintainer with these steps:
1. Deinstall webext-keepassxc-browser
2. Start Chromium
3. Install the KeePassXC-Browser extension with Chromium
4. The key is the value of the key 'key' in
   $HOME/.config/chromium/Extensions/<ID>/<VERSION>/manifest.json

See also:
https://stackoverflow.com/questions/21497781/how-to-change-chrome-packaged-app-id-or-why-do-we-need-key-field-in-the-manifest