Skip to content

Commit a6c519a

Browse files
committed
Extend the README with more info about testing the server locally.
Signed-off-by: Camila Ayres <[email protected]>
1 parent e8d5e1f commit a6c519a

File tree

1 file changed

+42
-16
lines changed

1 file changed

+42
-16
lines changed

README.md

Lines changed: 42 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -19,22 +19,24 @@ If the default `config.php` doesn't hold update information for this OEM, the co
1919
"stable": {
2020
"release": "2022-01-01 13:00",
2121
"linux": {
22-
"version": "2.3.2",
23-
"versionstring": "Nextcloud Client 2.3.2",
24-
"downloadurl": "https://download.nextcloud.com/desktop/releases/Linux/Nextcloud-2.3.2.1-setup.AppImage",
22+
"version": "3.2.1",
23+
"versionstring": "Nextcloud Client 3.2.1",
24+
"downloadurl": "https://download.nextcloud.com/desktop/releases/Linux/Nextcloud-3.2.1.AppImage",
2525
"web": "https://nextcloud.com/install/?pk_campaign=clientupdate#install-clients"
2626
},
2727
"win32": {
28-
"version": "2.3.2.1",
29-
"versionstring": "Nextcloud Client 2.3.2 (build 1)",
30-
"downloadurl": "https://download.nextcloud.com/desktop/releases/Windows/Nextcloud-2.3.2.1-setup.exe",
28+
"version": "3.2.1.0",
29+
"versionstring": "Nextcloud Client 3.2.1 (build 1234)",
30+
"downloadurl": "https://download.nextcloud.com/desktop/releases/Windows/Nextcloud-3.2.1-x64.msi",
3131
"web": "https://nextcloud.com/install/?pk_campaign=clientupdate#install-clients"
3232
},
3333
"macos": {
34-
"version": "2.2.4.1",
35-
"versionstring": "Nextcloud Client 2.2.4 (build 1)",
36-
"downloadurl": "https://download.nextcloud.com/desktop/releases/Mac/Updates/Nextcloud-2.2.4.1.pkg.tbz",
37-
"signature": "MCwCFGC3X/fejC/y/3T2X+c8ldDk7pJGAhQoR8v6vtvvV57nIcMNePA+jNRYcw=="
34+
"version": "3.5.2",
35+
"versionstring": "Nextcloud Client 3.5.2",
36+
"downloadurl": "https://download.nextcloud.com/desktop/releases/Mac/Installer/Nextcloud-3.15.2.pkg",
37+
"sparkleDownloadUrl": "https://download.nextcloud.com/desktop/releases/Mac/Installer/Nextcloud-3.15.2.pkg.tbz",
38+
"signature": "AAAaaaAAA001AAA001AAA001AAA001AAA123456001AAA+001AAA01+001AAA001AAA12345+001AAA001AAAA==",
39+
"length": 123123123
3840
}
3941
},
4042
"beta": {
@@ -52,17 +54,41 @@ If the default `config.php` doesn't hold update information for this OEM, the co
5254
"web": "https://nextcloud.com/install/?pk_campaign=clientupdate#install-clients"
5355
},
5456
"macos": {
55-
"version": "3.5.6-rc1",
56-
"versionstring": "Nextcloud Client 3.5.6 RC1",
57-
"downloadurl": "https://download.nextcloud.com/desktop/releases/Mac/Updates/Nextcloud-3.5.6-rc1-pkg.tbz",
58-
"signature": "MCwCFGC3X/fejC/y/3T2X+c8ldDk7pJGAhQoR8v6vtvvV57nIcMNePA+jNRYcw=="
57+
"version": "3.5.0-rc1",
58+
"versionstring": "Nextcloud Client 3.5.0 RC1",
59+
"downloadurl": "https://download.nextcloud.com/desktop/releases/Mac/Installer/Nextcloud-3.15.0-rc1.pkg",
60+
"sparkleDownloadUrl": "https://download.nextcloud.com/desktop/releases/Mac/Installer/Nextcloud-3.15.0-rc1.pkg.tbz",
61+
"signature": "AAAaaaAAA001AAA001AAA001AAA001AAA123456001AAA+001AAA01+001AAA001AAA12345+001AAA001AAAA==",
62+
"length": 123123123
5963
}
6064
}
6165
}
6266
```
6367

64-
## Developement
65-
To test this update server locally use `composer start`, which then will run the server on localhost port 1234.
68+
## Development
69+
70+
1. Create the json file in `config/` with the name of the OEM that contains the same entries as the `config.php`, e.g. `nextcloudev.json`.
71+
2. To test this update server locally use `composer start`, which then will run the server on localhost port 1234.
72+
3. Alternativately, you can directly execute: `php -S 0.0.0.0:1234 -t .`.
73+
4. To generate debug logs while developing:
74+
- Create a `php.ini` in the root folder with the following content:
75+
```
76+
error_log = /Users/camila/client_updater_server/test.log
77+
log_errors = on
78+
```
79+
- Start the development php server with: `php -S 0.0.0.0:1234 -c php.ini -t .`.
80+
81+
### Desktop client
82+
83+
- For all platforms, with cmake:
84+
- Enable `BUILD_UPDATER`.
85+
- Set `APPLICATION_UPDATE_URL` with `http://0.0.0.0:1234` or the following environment variable when running the client: `export OCC_UPDATE_URL="http://0.0.0.0:1234"`.
86+
- On mac OS:
87+
- Build the app bundle and codesign it using [mac-crafter](https://github.com/nextcloud/desktop/tree/master/admin/osx/mac-crafter).
88+
- Alternativately, with cmake:
89+
- Enable `BUILD_OWNCLOUD_OSX_BUNDLE`.
90+
- Set `SPARKLE_LIBRARY`.
91+
- `codesign` the `Sparkle.framework` and the app bundle.
6692
6793
## Deployment
6894

0 commit comments

Comments
 (0)