-
Notifications
You must be signed in to change notification settings - Fork 19
/
_HELP-create-build.txt
359 lines (201 loc) · 10.1 KB
/
_HELP-create-build.txt
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
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
#####################################
Version update - simplified
#####################################
Replace by using <Ctrl-H-> the old version with the new version, e.g. from "21.9.0" -> "21.12.0" in the workspaces
ws-MT-422
ws-mt-NL-projects
AND REVIEW IT MANUALLY IN ALL MODIFIED FILES, subversions must not be modified everywhere, take care with
"feature.xml" in "feature.net.tourbook.app"
"feature.xml" in "feature.net.tourbook.app.nl"
#####################################
One Click build process (since 18.1)
#####################################
* Set java path in C:\Users\Wolfgang\.gradle\gradle.properties
* Set version number in gradle.properties in the .git root
* Set version number as described below (Build with POM)
Run "gradlew" in "C:\DAT\MT\mytourbook\build\build.net.tourbook" this will run the default task
Setup to run gradle:
JAVA_HOME =C:\Program Files\AdoptOpenJDK\jdk-11.0.11.9-hotspot\
Path =C:\Program Files\AdoptOpenJDK\jdk-11.0.11.9-hotspot\bin;
C:\BIN\gradle\gradle-6.9\bin;
C:\BIN\maven\bin\;
Setup the graddle wrapper in the build folder:
gradlew wrapper --gradle-version 8.2.1
#################
Build VTM Plugin
#################
Setup Gradle environment
- Set "org.gradle.java.home=C:/Program Files/Eclipse Adoptium/jdk-11.0.17.8-hotspot"
in C:\Users\Wolfgang\.gradle\gradle.properties
Build VTM plugin for MT
- Check versions in (gdxVersion) /mytourbook/bundles/build.gradle
- Update VTM files, run task assemble:
cd C:\DAT\MT\vtm-parent
gradlew clean ass
- Update VTM plugin, run task assemble:
cd C:\DAT\MT\mytourbook\bundles\net.tourbook.ext.vtm
gradle clean ass
TEST VTM
- Run playground
cd C:\DAT\MT\vtm-parent
run-playground.cmd
- Copy debug files
cd C:\DAT\MT\vtm-parent
gradlew copyDebugFiles
- Fat jar
cd C:\DAT\MT\vtm-parent
gradlew :vtm-playground:fatJar
- Other VTM Tests
https://github.com/mapsforge/vtm/blob/master/docs/desktop.md
###########################
Update Eclipse NL repo
###########################
see "build\build.eclipse.4.23.nl.repo\How to update this p2 repo.txt"
################################################################
Create Dojo files, when web-UI in net.tourbook.web is modified
################################################################
- Set "IS_DEBUG = false" in net.tourbook.web.WEB
- 1. run script /build.net.tourbook.ant/build-files/Convert-i18-To-Dojo.xml
- 2. run script /net.tourbook.web/build-files/Create-Dojo-Bundle.xml
###########################
Build with POM (since 16.4)
###########################
Switch to workspace "C:\DAT\ws-mt-NL-projects"
----------------------------------------------
- refresh all projects with F5
- Replace text (Ctrl-H) "x.y.0.qualifier" to "a.b.0.qualifier" in all NL projects
THIS SEEMS TO BE OBSOLETE
- Replace text (Ctrl-H) "x.y.0" to "a.b.0" in
- All NL projects
- "site.xml" in the project "translation-test-update-site" that the
translation test update site can be build OTHERWISE it is NOT working
Switch to workspace "C:\DAT\ws_MT-e48"
--------------------------------------
Set version number / year
-------------------------
The shortcut is to replace x.y.z with a.b.c but beware of this
BUT ONLY WHEN A MAJOR RELEASE IS CREATED DON'T MODIFY match="equivalent" VERSION WHEN AN UPDATE SITE IS CREATED
"feature.xml" in "feature.net.tourbook.app"
"feature.xml" in "feature.net.tourbook.app.nl"
/// OLD procedure - Start ////////////////////////////////////
- Replace year in "net.tourbook.application.ApplicationVersion"
- Replace text (Ctrl-H) "x.y.0-SNAPSHOT" to "a.b.0-SNAPSHOT" in all "pom*.xml"
- Replace text (Ctrl-H) "x.y.0.qualifier" to "a.b.0.qualifier" in all other files
- Replace text (Ctrl-H) "x.y.z" to "a.b.c" in "about.mappings"
- Replace text (Ctrl-H) "x.y.z" to "a.b.c" in these files
BUT ONLY WHEN A MAJOR RELEASE IS CREATED DON'T MODIFY match="equivalent" VERSION WHEN AN UPDATE SITE IS CREATED
"feature.xml" in "feature.net.tourbook.app"
"feature.xml" in "feature.net.tourbook.app.nl"
This version ensures that a software update is done ONLY for the current version, VERY TRICKY
<import feature="feature.net.tourbook.app.version" version="16.2.0" match="equivalent"/>
Win-Installer
- Set version number in "INSTALL-UPDATES\installer-net.tourbook\win-Inno.Setup\mytourbook-include-app.iss"
/// OLD procedure - End //////////////////////////////////////
Remove debug code
-----------------
* Section "configIni" in "net.tourbook.product"
Disable "<win32>config-win-DEBUG.ini</win32>"
Enable "<win32>config-win.ini</win32>"
Copy/Merge app files to build folder
--------------------------
Run ant script "CREATE_MT_BuildFiles.xml" in project "build.net.tourbook"
Build Product
--------------
Open cmd
- Select folder "C:\DAT\MT\mytourbook"
- Run "mvn verify -P build-release"
- Run "mvn verify -P build-release -X --log-file ../log.txt" this will log into a file
OR run "build-MT-with-log-file.cmd" in "C:\DAT\MT\mytourbook\build\build.net.tourbook"
#################
Build Update Site
#################
!!! BEFORE !!!
1. Set version numbers like in this commit https://github.com/mytourbook/mytourbook/commit/4ad360673bea889647dfb54f7c754c8bb41984b0
2. Run "CREATE_MT_BuildFiles.xml" BEFORE the following commands
* WITH NL
Open cmd
- Select folder "cd C:\DAT\MT\mytourbook"
- Run "mvn verify -P build-update-site"
* WITHOUT NL
Open cmd
- Select folder "cd C:\DAT\MT\mytourbook"
- Run "mvn verify -P build-update-site-no-nl"
* Test translations
-------------------
- Select favorite mt-TRANSLATION-TEST in Q-Dir
- Select folder "C:\DAT\ws_mt-Translation-TEST"
- Delete all folders and files but NOT ".metadata"
- Extract "mt-translations.zip" into this folder
- Switch to workspace "C:\DAT\ws_mt-Translation-TEST"
- Refresh all projects with F5
- Run Project/clean... for all projects
3.8.2 Archives used in pom.xml
------------------------------
local location: C:\DAT\MT\mytourbook\repositories
http://archive.eclipse.org/eclipse/downloads/drops/R-3.8.2-201301310800/org.eclipse.pde-3.8.2.zip
http://archive.eclipse.org/eclipse/downloads/drops/R-3.8.2-201301310800/org.eclipse.jdt-3.8.2.zip
http://archive.eclipse.org/eclipse/downloads/drops/R-3.8.2-201301310800/org.eclipse.rcp-3.8.2.zip
http://archive.eclipse.org/eclipse/downloads/drops/R-3.8.2-201301310800/org.eclipse.platform-3.8.2.zip
############################################################################
############################################################################
BUILD COMMANDS BEFORE TYCHO (<= 16.1)
############################################################################
############################################################################
##########################
Create Translation Archive
##########################
- switch to workspace "C:\DAT\ws_MT-e38"
- set version number in "feature.net.tourbook.app"
- force feature version number into net.tourbook.* plugins
- set synch option back to "synch versions on build (recommended)"
- switch to workspace "C:\DAT\ws_mt-NL-projects"
- refresh all projects with F5
- set version number into "feature.xml" in "feature.net.tourbook.app.nl"
- force feature version number into the *.nl fragments
- set synch option back to "synch versions on build (recommended)"
- set version number into "feature.xml" in "feature.z-Dummy-Host"
- force feature version number into dummy host plugins
- set synch option back to "synch versions on build (recommended)"
- switch to workspace "C:\DAT\ws_MT-e38"
- run script "Create_Translation_Archive"
* Test translations
-------------------
- select favorite mt-TRANSLATION-TEST in Q-Dir
- select folder "C:\DAT\ws_mt-Translation-TEST"
- delete all folders but NOT ".metadata"
- extract "mt-translations.zip" into this folder
- switch to workspace "C:\DAT\ws_mt-Translation-TEST"
- refresh all projects with F5
- run Project/clean... for all projects
############
Create Build
############
requirements:
- buckminster is installed to see better error messages
(buckminster developemnet is not continued, TYCHO is used to build eclipse projects)
- switch to workspace "C:\DAT\ws_mt-with-GIT or ws_MT-E4"
- set version number in
- about.mappings
- net.tourbook.application.ApplicationVersion
- run script "Create_MyTourbook_BuildFiles" in plugin net.tourbook/build-files
- switch to workspace "C:\DAT\mytourbook-BUILD-ws"
- refresh all projects with F5
- run Project/clean... for all projects
- update version number in build.feature.net.tourbook.product
- replace feature net.tourbook.product.feature with new version number
- set build target correctly ???
- delete old exported files when a reexport is done,
export will add new files to an existing product archive
- run product export wizard in the product file
##################
Create Update Site
##################
- check which plugins needs to be contained in the update site and update plugin version number
- create translation archive when necessary, see above instructions
- switch to workspace "C:\DAT\ws_mt-with-GIT or ws_MT-E4"
- run script "Create_MyTourbook_BuildFiles"
- switch to workspace "C:\DAT\mytourbook-BUILD-ws"
- refresh all projects with F5
- run Project/clean... for all projects
- run script "clear-update-site.xml" in the project "update-site.mytourbook"
- build the update site within site.xml