Skip to Content
Version 4.1 by christoph_lechleitner@iteg_at on 2012-07-20 10.58:33
Show last authors
1 Setting up a portable C++ project still is a pain in the ass, especially if it shall be portable.
2
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.
4
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
9 ===== {{id name="PBA-cbsbootstrappingofportableC++project-Preparations"/}}Preparations =====
10
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
13 For starters, You need to install the packages {{code language="none"}}pba-cbs{{/code}} and {{code language="none"}}subversion{{/code}}.
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"}}
26 svn export "https://svn.clazzes.org/svn/pba/trunk/pba-helloworld-portable" $MYAPPNAME
27 {{/code}}
28
29 ===== {{id name="PBA-cbsbootstrappingofportableC++project-Renameandsearch'n'replace"/}}Rename and search'n'replace =====
30
31 Rename some stuff and have the inlcude files adapted:
32
33 {{code language="none"}}
34 cd $MYAPPNAME
35  
36 scripts/rename_main_files.sh $MYAPPNAME
37 {{/code}}
38
39 ===== {{id name="PBA-cbsbootstrappingofportableC++project-Adaptdebianinformation"/}}Adapt debian information =====
40
41 Change my name and e-mail to yours and adapt the description:
42
43 {{code language="none"}}
44 $EDITOR debian*/control debian*/changelog
45 {{/code}}
46
47 ===== {{id name="PBA-cbsbootstrappingofportableC++project-Optional:AdapttheWindowsrctemplate..."/}}Optional: Adapt the Windows rc template ... =====
48
49 If you want windows binaries, edit the resoure template:
50
51 {{code language="none"}}
52 $EDITOR src/*.rc
53 {{/code}}
54
55 Do not forget to change the icon, too!
56
57 ===== {{id name="PBA-cbsbootstrappingofportableC++project-Alternatively:Removewindowsstuff"/}}Alternatively: Remove windows stuff =====
58
59 If you do not want windows binaries, remove it:
60
61 (((
62 {{code language="none"}}
63 rm -rf src/include-mingw.mk src/*.rc debian-mingw* build/win*
64 {{/code}}
65
66 ===== {{id name="PBA-cbsbootstrappingofportableC++project-Optional:Activatesvnoranotherrevisioncontrolsystem"/}}Optional: Activate svn or another revision control system =====
67 )))
68
69 Now (and before any build activity) is a very good time to put your project under subversion control:
70
71 {{code language="none"}}
72 svn add `pwd`
73 {{/code}}
74
75 You might also want to fill {{code language="none"}}svn:ignore{{/code}} properties of some directories:
76
77 {{code language="none"}}
78 scripts/set_svn_ignore.sh
79 {{/code}}
80
81 ===== {{id name="PBA-cbsbootstrappingofportableC++project-Optional:Installrequiredlibsandbuildthepackage"/}}Optional: Install required libs and build the package =====
82
83 To produce the debian packages, just:
84
85 {{code language="none"}}
86 # this needs sudo privileges
87 pba-builddeps -i
88  
89 pba-build -u
90
91 # or dpkg-build*
92 {{/code}}
93
94 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.
95
96 We will soon add NSIS installers.
97
98