blob: 7936efebf0d9bc4e4c546246f6ce1126b0a9713d (
plain)
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
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
|
### Development requirements
A running Nextcloud instance with the passwords app installed.
You can find instructions to set up a test server in the [main project](https://github.com/marius-wieschollek/passwords)
Firefox and Chromium are required.
_Using a test account is recommended_
A [test server can be found here](https://test.passwordsapp.org/apps/cms_pico/pico/passwords_test).
### Building from source
##### Project Setup
1. Run `git submodule sync --recursive` from the command line
1. Run `git submodule update --init --recursive` from the command line
1. Run `npm install` from the command line
##### For Firefox
1. Run `npm run build:firefox`
2. Open "about:debugging" in Firefox
3. Click "Load Temporary Add-on"
4. Select the manifest.json in the "dist" folder in the file popup.
##### For Chromium
1. Run `npm run build:chrome`
2. Open "chrome://extensions/" in Chromium
3. Enable "Developer Mode"
4. Click "Load unpacked extension"
5. Select the "dist" folder in the file popup
### Installing from source
##### Project Setup
1. Run `npm install` from the command line
##### For Firefox
1. Run `npm run watch:firefox`
2. Open "about:debugging" in Firefox
3. Click "Load Temporary Add-on"
4. Select the manifest.json in the "dist" folder in the file popup.
##### For Chromium
1. Run `npm run watch:chrome`
2. Open "chrome://extensions/" in Chromium
3. Enable "Developer Mode"
4. Click "Load unpacked extension"
5. Select the "dist" folder in the file popup
### Debugging
##### In Firefox
1. Open "about:debugging"
2. Enable "Activate debugging of extensions"
3. Scroll to "Passwords for Nextcloud Client" and click on "Debug"
4. Confirm the debugging request
##### In Chromium
1. Open "chrome://extensions/"
2. Scroll to "Passwords for Nextcloud Client" and click on "Background Page" or "Errors"
### Packing
##### Build on Firefox
1. Run `npm build:firefox`
2. Pack the contents of the "dist" folder to a .zip file
3. Rename the file to "ncpasswords@mdns.eu.xpi"
##### Build on Chromium
1. Run `npm build:chrome`
2. Open "chrome://extensions/" in Chromium
3. Enable "Developer mode"
4. Click "Pack extension"
5. Select the "dist" folder in the file popup
6. If you have a private key file, select it as well
7. Click on "Pack extension"
### Debug API/Connection issues
1. Follow the steps in [Debugging](#debugging) for your browser
2. Execute the synchronisation action in the extension interface
3. Network activity should appear in the "Network" tab
4. Failed requests should be logged in the "Console"
### Tasks for starters
You can always help translating the app.
The translation files can be found in `src/platform/generic/_locales/<language>`.
Use the english language for reference.
|
