Skip to Content
Last modified by christoph_lechleitner@iteg_at on 2018-01-03 03.50:49
From version 3.1
edited by christoph_lechleitner@iteg_at
on 2012-07-20 06.31:00
Change comment: There is no comment for this version
To version 18.1
edited by christoph_lechleitner@iteg_at
on 2016-12-06 03.54:51
Change comment: HInt mingw-5 removal

Summary

Details

Page properties
Content
... ... @@ -6,11 +6,11 @@
6 6  
7 7  These are the steps for an ultra fast bootstrapping of a portable project relying on pba-cbs and [[our incarnation of the MinGW cross compilation toolchain>>doc:MINGW64.WebHome]].
8 8  
9 -===== {{id name="PBA-cbsbootstrappingofportableC++project-Prepare"/}}Prepare =====
9 +===== {{id name="PBA-cbsbootstrappingofportableC++project-Preparations"/}}Preparations =====
10 10  
11 -Just to avoid frustration: You need the {{code language="none"}}pba-cbs{{/code}} package installed, using i.e. the {{code language="none"}}pba{{/code}} debsource from [[https:~~/~~/deb.clazzes.org>>url:https://deb.clazzes.org||shape="rect"]].
11 +You need deb sources for {{code language="none"}}pba{{/code}} ({{code language="none"}}any-pba-1.0{{/code}}) and //distro//{{code language="none"}}-mingw-5{{/code}} (i.e. {{code language="none"}}squeeze-mingw-5{{/code}} or {{code language="none"}}wheezy-mingw-5{{/code}}), see [[https:~~/~~/deb.clazzes.org>>url:https://deb.clazzes.org/||shape="rect"]].
12 12  
13 -{{code language="none"}}pba-cbs{{/code}} depends on required packages, but do not forget {{code language="none"}}subversion{{/code}}, {{code language="none"}}gcc{{/code}}, ...
13 +For starters, You need to install the packages {{code language="none"}}pba-cbs{{/code}} and {{code language="none"}}subversion{{/code}}.
14 14  
15 15  ===== {{id name="PBA-cbsbootstrappingofportableC++project-Retrievethesceleton"/}}Retrieve the sceleton =====
16 16  
... ... @@ -23,7 +23,14 @@
23 23  Export our example from public svn:
24 24  
25 25  {{code language="none"}}
26 +# for a flat application project:
26 26  svn export "https://svn.clazzes.org/svn/pba/trunk/pba-helloworld-portable" $MYAPPNAME
28 +
29 +# for a multi-module multi-program application project:
30 +svn export "https://svn.clazzes.org/svn/pba/trunk/pba-hellobigworld-portable" $MYAPPNAME
31 + 
32 +# for a library project:
33 +svn export "https://svn.clazzes.org/svn/pba/trunk/pba-hellolib-portable" $MYAPPNAME
27 27  {{/code}}
28 28  
29 29  ===== {{id name="PBA-cbsbootstrappingofportableC++project-Renameandsearch'n'replace"/}}Rename and search'n'replace =====
... ... @@ -34,52 +34,58 @@
34 34  cd $MYAPPNAME
35 35   
36 36  scripts/rename_main_files.sh $MYAPPNAME
44 + 
45 +rm scripts/rename_main_files.sh
37 37  {{/code}}
38 38  
39 -===== {{id name="PBA-cbsbootstrappingofportableC++project-Adaptdebianinformation..."/}}Adapt debian information ... =====
48 +===== {{id name="PBA-cbsbootstrappingofportableC++project-Optional:Removewindowsstuff"/}}Optional: Remove windows stuff =====
40 40  
41 -If you want debian-packages, edit them, change my name and e-mail to yours and adapt the description:
50 +If you do not want windows binaries, remove it:
42 42  
43 -{{code language="none"}}
44 -$EDITOR debian*/control debian*/changelog
45 -{{/code}}
52 +(((
53 +
46 46  
47 -===== {{id name="PBA-cbsbootstrappingofportableC++project-...ordropdebian/"/}}... or drop debian/ =====
48 -
49 -If you do not want debian packages, just remove the debian directory:
50 -
51 51  {{code language="none"}}
52 -rm -rf debian*
56 +# Variant 1: Remove NSIS installer only. For libraries common despite cross compilation.
57 +rm -rf nsis src/*.nsi
58 +
59 +# Variant 2: Remove NSIS installer and mingw-5
60 +rm -rf nsis src/*.nsi debian-mingw-5
61 +# Variant 3: Remove all windows crossbuilding stuff
62 +rm -rf nsis src/*.nsi src/include-mingw.mk src/*.rc debian-mingw* build/win*
63 +$EDITOR build/Makefile
53 53  {{/code}}
54 54  
55 -===== {{id name="PBA-cbsbootstrappingofportableC++project-AdapttheWindowsrctemplate..."/}}Adapt the Windows rc template ... =====
66 +===== {{id name="PBA-cbsbootstrappingofportableC++project-Adaptdebianpackagemetainfos"/}}(% style="color: rgb(112,112,112);" %)Adapt debian package meta infos(%%) =====
67 +)))
56 56  
57 -If you want windows binaries, edit the resoure template:
69 +Change my name and e-mail to yours and adapt the description:
58 58  
59 59  {{code language="none"}}
60 -$EDITOR src/*.rc
72 +$EDITOR debian*/control debian*/changelog $(ls -1 src/*.pc.tmpl src/*.rc src/*.nsi src/*.h 2>/dev/null)
61 61  {{/code}}
62 62  
63 -Do not forget to change the icon, too!
75 +(% style="color: rgb(51,51,51);" %)Do not forget to change the icon, too!
64 64  
65 -===== {{id name="PBA-cbsbootstrappingofportableC++project-...orremoveit"/}}... or remove it =====
77 +===== {{id name="PBA-cbsbootstrappingofportableC++project-UpdateorremovetheReadMe"/}}Update or remove the ReadMe =====
66 66  
67 -If you do not want windows binaries, remove it:
79 +At least remove the link to this page ...
68 68  
69 -(((
70 70  {{code language="none"}}
71 -rm src/*.rc
82 +# edit ...
83 +$EDITOR doc/ReadMe.txt
84 + 
85 +# ... or remove the file and the reference in debian*/rules
86 +rm doc/ReadMe.txt
87 +$EDITOR debian*/rules
72 72  {{/code}}
73 73  
74 -In most cases you just broke the windows build!
90 +===== {{id name="PBA-cbsbootstrappingofportableC++project-Optional:Activatesvnoranotherrevisioncontrolsystem"/}}(% style="line-height: 1.6666666;" %)Optional: Activate svn or another revision control system(%%) =====
75 75  
76 -===== {{id name="PBA-cbsbootstrappingofportableC++project-Optional:Activatesvnoranotherrevisioncontrol"/}}Optional: Activate svn or another revision control =====
77 -)))
78 -
79 79  Now (and before any build activity) is a very good time to put your project under subversion control:
80 80  
81 81  {{code language="none"}}
82 -svn add .
95 +svn add `pwd`
83 83  {{/code}}
84 84  
85 85  You might also want to fill {{code language="none"}}svn:ignore{{/code}} properties of some directories:
... ... @@ -88,26 +88,61 @@
88 88  scripts/set_svn_ignore.sh
89 89  {{/code}}
90 90  
91 -===== {{id name="PBA-cbsbootstrappingofportableC++project-Optional:buildit"/}}Optional: build it =====
104 +===== {{id name="PBA-cbsbootstrappingofportableC++project-Optional:Installrequiredlibsandbuildthepackage"/}}Optional: Install required libs and build the package =====
92 92  
93 -To produce a debian package, just:
106 +To produce the debian packages, just:
94 94  
95 95  {{code language="none"}}
96 -pba-build -u
109 +# this needs sudo privileges
110 +pba-builddeps -i
97 97   
112 +pba-build -u
113 +
98 98  # or dpkg-build*
99 99  {{/code}}
100 100  
101 -We will soon add {{code language="none"}}debian-mingw-*/{{/code}} directories and NSIS installers, for now for Windows just use make:
117 +To only build the linux packages or only the windows packages, add {{code language="none"}}-o unix{{/code}} resp. {{code language="none"}}-o mingw{{/code}} to the pba-commands.
102 102  
119 +===== {{id name="PBA-cbsbootstrappingofportableC++project-Optional:CreateWindowsInstallers"/}}Optional: Create Windows Installers =====
120 +
121 +(Re)edit the {{code language="none"}}.nsi{{/code}} script template and replace all instances of "{{code language="none"}}Clazzes.org{{/code}}" with something of your choice:
122 +
103 103  {{code language="none"}}
104 -make -C build/win32/release/
124 +$EDITOR src/*.nsi
125 +{{/code}}
105 105  
106 -make -C build/win64/release/
127 +Then "make" the {{code language="none"}}nsis{{/code}} directory:
128 +
129 +{{code language="none"}}
130 +make -C nsis && ls -ltr nsis/*.exe
107 107  {{/code}}
108 108  
109 -
133 +===== {{id name="PBA-cbsbootstrappingofportableC++project-Optionalmulti-module/multi-programvariant:CreateModules,Programs"/}}Optional multi-module/multi-program variant: Create Modules, Programs =====
110 110  
111 -
135 +{{code language="none"}}
136 +# create module common
137 +scripts/create_module.sh common
138 + 
139 +# create program foobar-daemon
140 +scripts/create_program.sh foobar-daemon
141 +{{/code}}
112 112  
113 -
143 +== {{id name="PBA-cbsbootstrappingofportableC++project-EclipseHints"/}}Eclipse Hints ==
144 +
145 +To create the Ecplise project, select File, New, Project..., C/C++, Makefile Project with existing code.
146 +
147 +The recommended Build Configurations and their Build directories are:
148 +
149 +{{code language="none"}}
150 +# Debug
151 +${ProjDirPath}/build/unix/debug
152 + 
153 +# Release
154 +${ProjDirPath}/build/unix/release
155 + 
156 +# Win32
157 +${ProjDirPath}/build/win32/release
158 + 
159 +# Win64
160 +${ProjDirPath}/build/win64/release
161 +{{/code}}
Confluence.Code.ConfluencePageClass[0]
Id
... ... @@ -1,1 +1,1 @@
1 -659174
1 +659152
URL
... ... @@ -1,1 +1,1 @@
1 -https://clazzes.atlassian.net/wiki/spaces/PBA/pages/659174/PBA-cbs bootstrapping of portable C++ project
1 +https://clazzes.atlassian.net/wiki/spaces/PBA/pages/659152/PBA-cbs bootstrapping of portable C++ project