Skip to Content
Version 17.1 by christoph_lechleitner@iteg_at on 2014-08-04 11.58:16
Hide last authors
christoph_lechleitner@iteg_at 2.1 1 Setting up a portable C++ project still is a pain in the ass, especially if it shall be portable.
christoph_lechleitner@iteg_at 1.1 2
christoph_lechleitner@iteg_at 2.1 3 When trying to automate it in some way, we came to the conclusion that a full example in a public subversion repository is a good solutions because it's easy to use for you and easy to maintain for us.
christoph_lechleitner@iteg_at 1.1 4
christoph_lechleitner@iteg_at 2.1 5 === {{id name="PBA-cbsbootstrappingofportableC++project-HowTo..."/}}HowTo ... ===
6
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
christoph_lechleitner@iteg_at 4.1 9 ===== {{id name="PBA-cbsbootstrappingofportableC++project-Preparations"/}}Preparations =====
christoph_lechleitner@iteg_at 2.1 10
christoph_lechleitner@iteg_at 4.1 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"]].
christoph_lechleitner@iteg_at 2.1 12
christoph_lechleitner@iteg_at 4.1 13 For starters, You need to install the packages {{code language="none"}}pba-cbs{{/code}} and {{code language="none"}}subversion{{/code}}.
christoph_lechleitner@iteg_at 2.1 14
15 ===== {{id name="PBA-cbsbootstrappingofportableC++project-Retrievethesceleton"/}}Retrieve the sceleton =====
16
17 Decide for the main name of your app:
18
19 {{code language="none"}}
20 MYAPPNAME="myapp"
21 {{/code}}
22
23 Export our example from public svn:
24
25 {{code language="none"}}
christoph_lechleitner@iteg_at 16.1 26 # for a flat application project:
christoph_lechleitner@iteg_at 2.1 27 svn export "https://svn.clazzes.org/svn/pba/trunk/pba-helloworld-portable" $MYAPPNAME
christoph_lechleitner@iteg_at 16.1 28
christoph_lechleitner@iteg_at 17.1 29 # BETA: for a multi-module multi-program application project:
christoph_lechleitner@iteg_at 16.1 30 svn export "https://svn.clazzes.org/svn/pba/trunk/pba-hellobigworld-portable" $MYAPPNAME
christoph_lechleitner@iteg_at 10.1 31  
32 # for a library project:
33 svn export "https://svn.clazzes.org/svn/pba/trunk/pba-hellolib-portable" $MYAPPNAME
christoph_lechleitner@iteg_at 2.1 34 {{/code}}
35
36 ===== {{id name="PBA-cbsbootstrappingofportableC++project-Renameandsearch'n'replace"/}}Rename and search'n'replace =====
37
38 Rename some stuff and have the inlcude files adapted:
39
40 {{code language="none"}}
41 cd $MYAPPNAME
42  
43 scripts/rename_main_files.sh $MYAPPNAME
christoph_lechleitner@iteg_at 6.1 44  
45 rm scripts/rename_main_files.sh
christoph_lechleitner@iteg_at 2.1 46 {{/code}}
47
christoph_lechleitner@iteg_at 9.1 48 ===== {{id name="PBA-cbsbootstrappingofportableC++project-Optional:Removewindowsstuff"/}}Optional: Remove windows stuff =====
49
50 If you do not want windows binaries, remove it:
51
52 (((
christoph_lechleitner@iteg_at 10.1 53
54
christoph_lechleitner@iteg_at 9.1 55 {{code language="none"}}
christoph_lechleitner@iteg_at 13.1 56 # Variant 1: Remove NSIS installer only. For libraries common despite cross compilation.
christoph_lechleitner@iteg_at 11.1 57 rm -rf nsis src/*.nsi
58  
christoph_lechleitner@iteg_at 13.1 59 # Variant 2: Remove all windows crossbuilding stuff
christoph_lechleitner@iteg_at 11.1 60 rm -rf nsis src/*.nsi src/include-mingw.mk src/*.rc debian-mingw* build/win*
christoph_lechleitner@iteg_at 13.1 61 $EDITOR build/Makefile
christoph_lechleitner@iteg_at 9.1 62 {{/code}}
christoph_lechleitner@iteg_at 10.1 63
christoph_lechleitner@iteg_at 11.1 64 ===== {{id name="PBA-cbsbootstrappingofportableC++project-Adaptdebianpackagemetainfos"/}}(% style="color: rgb(112,112,112);" %)Adapt debian package meta infos(%%) =====
christoph_lechleitner@iteg_at 9.1 65 )))
66
christoph_lechleitner@iteg_at 4.1 67 Change my name and e-mail to yours and adapt the description:
christoph_lechleitner@iteg_at 2.1 68
69 {{code language="none"}}
christoph_lechleitner@iteg_at 15.1 70 $EDITOR debian*/control debian*/changelog $(ls -1 src/*.pc.tmpl src/*.rc src/*.nsi src/*.h 2>/dev/null)
christoph_lechleitner@iteg_at 2.1 71 {{/code}}
72
christoph_lechleitner@iteg_at 11.1 73 (% style="color: rgb(51,51,51);" %)Do not forget to change the icon, too!
christoph_lechleitner@iteg_at 2.1 74
christoph_lechleitner@iteg_at 11.1 75 ===== {{id name="PBA-cbsbootstrappingofportableC++project-UpdateorremovetheReadMe"/}}Update or remove the ReadMe =====
76
77 At least remove the link to this page ...
78
christoph_lechleitner@iteg_at 2.1 79 {{code language="none"}}
christoph_lechleitner@iteg_at 11.1 80 # edit ...
81 $EDITOR doc/ReadMe.txt
82  
christoph_lechleitner@iteg_at 14.1 83 # ... or remove the file and the reference in debian*/rules
christoph_lechleitner@iteg_at 11.1 84 rm doc/ReadMe.txt
christoph_lechleitner@iteg_at 14.1 85 $EDITOR debian*/rules
christoph_lechleitner@iteg_at 2.1 86 {{/code}}
87
christoph_lechleitner@iteg_at 9.1 88 ===== {{id name="PBA-cbsbootstrappingofportableC++project-Optional:Activatesvnoranotherrevisioncontrolsystem"/}}(% style="line-height: 1.6666666;" %)Optional: Activate svn or another revision control system(%%) =====
christoph_lechleitner@iteg_at 2.1 89
90 Now (and before any build activity) is a very good time to put your project under subversion control:
91
92 {{code language="none"}}
christoph_lechleitner@iteg_at 4.1 93 svn add `pwd`
christoph_lechleitner@iteg_at 2.1 94 {{/code}}
95
96 You might also want to fill {{code language="none"}}svn:ignore{{/code}} properties of some directories:
97
98 {{code language="none"}}
99 scripts/set_svn_ignore.sh
100 {{/code}}
101
christoph_lechleitner@iteg_at 4.1 102 ===== {{id name="PBA-cbsbootstrappingofportableC++project-Optional:Installrequiredlibsandbuildthepackage"/}}Optional: Install required libs and build the package =====
christoph_lechleitner@iteg_at 2.1 103
christoph_lechleitner@iteg_at 4.1 104 To produce the debian packages, just:
christoph_lechleitner@iteg_at 2.1 105
106 {{code language="none"}}
christoph_lechleitner@iteg_at 4.1 107 # this needs sudo privileges
108 pba-builddeps -i
109  
christoph_lechleitner@iteg_at 2.1 110 pba-build -u
christoph_lechleitner@iteg_at 4.1 111
christoph_lechleitner@iteg_at 2.1 112 # or dpkg-build*
113 {{/code}}
114
christoph_lechleitner@iteg_at 4.1 115 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.
christoph_lechleitner@iteg_at 2.1 116
christoph_lechleitner@iteg_at 5.1 117 ===== {{id name="PBA-cbsbootstrappingofportableC++project-Optional:CreateWindowsInstallers"/}}Optional: Create Windows Installers =====
christoph_lechleitner@iteg_at 2.1 118
christoph_lechleitner@iteg_at 11.1 119 (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:
christoph_lechleitner@iteg_at 5.1 120
121 {{code language="none"}}
122 $EDITOR src/*.nsi
123 {{/code}}
124
125 Then "make" the {{code language="none"}}nsis{{/code}} directory:
126
127 {{code language="none"}}
128 make -C nsis && ls -ltr nsis/*.exe
129 {{/code}}
christoph_lechleitner@iteg_at 15.1 130
christoph_lechleitner@iteg_at 16.1 131 ===== {{id name="PBA-cbsbootstrappingofportableC++project-Optionalmulti-module/multi-programvariant:CreateModules,Programs"/}}Optional multi-module/multi-program variant: Create Modules, Programs =====
132
133 {{code language="none"}}
134 # create module common
135 scripts/create_module.sh common
136  
137 # create program foobar-daemon
138 scripts/create_program.sh foobar-daemon
139 {{/code}}
140
christoph_lechleitner@iteg_at 15.1 141 == {{id name="PBA-cbsbootstrappingofportableC++project-EclipseHints"/}}Eclipse Hints ==
142
143 To create the Ecplise project, select File, New, Project..., C/C++, Makefile Project with existing code.
144
145 The recommended Build Configurations and their Build directories are:
146
147 {{code language="none"}}
148 # Debug
149 ${ProjDirPath}/build/unix/debug
150  
151 # Release
152 ${ProjDirPath}/build/unix/release
153  
154 # Win32
155 ${ProjDirPath}/build/win32/release
156  
157 # Win64
158 ${ProjDirPath}/build/win64/release
159 {{/code}}