Skip to Content
Version 11.1 by christoph_lechleitner@iteg_at on 2014-01-11 03.10:43
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 # for an application project:
27 svn export "https://svn.clazzes.org/svn/pba/trunk/pba-helloworld-portable" $MYAPPNAME
28  
29 # for a library project:
30 svn export "https://svn.clazzes.org/svn/pba/trunk/pba-hellolib-portable" $MYAPPNAME
31 {{/code}}
32
33 ===== {{id name="PBA-cbsbootstrappingofportableC++project-Renameandsearch'n'replace"/}}Rename and search'n'replace =====
34
35 Rename some stuff and have the inlcude files adapted:
36
37 {{code language="none"}}
38 cd $MYAPPNAME
39  
40 scripts/rename_main_files.sh $MYAPPNAME
41  
42 rm scripts/rename_main_files.sh
43 {{/code}}
44
45 ===== {{id name="PBA-cbsbootstrappingofportableC++project-Optional:Removewindowsstuff"/}}Optional: Remove windows stuff =====
46
47 If you do not want windows binaries, remove it:
48
49 (((
50
51
52 {{code language="none"}}
53 # remove nsis stuff. For libraries common despite cross compilation
54 rm -rf nsis src/*.nsi
55  
56 # remove all windows crossbuilding stuff
57 rm -rf nsis src/*.nsi src/include-mingw.mk src/*.rc debian-mingw* build/win*
58 {{/code}}
59
60 ===== {{id name="PBA-cbsbootstrappingofportableC++project-Adaptdebianpackagemetainfos"/}}(% style="color: rgb(112,112,112);" %)Adapt debian package meta infos(%%) =====
61 )))
62
63 Change my name and e-mail to yours and adapt the description:
64
65 {{code language="none"}}
66 $EDITOR debian*/control debian*/changelog $(ls -1 src/*.pc.tmpl src/*.rc src/*.nsi 2>/dev/null)
67 {{/code}}
68
69 (% style="color: rgb(51,51,51);" %)Do not forget to change the icon, too!
70
71 ===== {{id name="PBA-cbsbootstrappingofportableC++project-"/}}(% style="line-height: 1.6666666;" %) (%%) =====
72
73 ===== {{id name="PBA-cbsbootstrappingofportableC++project-UpdateorremovetheReadMe"/}}Update or remove the ReadMe =====
74
75 ===== {{id name="PBA-cbsbootstrappingofportableC++project-"/}}(% style="line-height: 1.6666666;" %) (%%) =====
76
77 At least remove the link to this page ...
78
79 ===== {{id name="PBA-cbsbootstrappingofportableC++project-"/}}(% style="line-height: 1.6666666;" %) (%%) =====
80
81 {{code language="none"}}
82 # edit ...
83 $EDITOR doc/ReadMe.txt
84  
85 # ... or remove
86 rm doc/ReadMe.txt
87 {{/code}}
88
89 ===== {{id name="PBA-cbsbootstrappingofportableC++project-Optional:Activatesvnoranotherrevisioncontrolsystem"/}}(% style="line-height: 1.6666666;" %)Optional: Activate svn or another revision control system(%%) =====
90
91 Now (and before any build activity) is a very good time to put your project under subversion control:
92
93 {{code language="none"}}
94 svn add `pwd`
95 {{/code}}
96
97 You might also want to fill {{code language="none"}}svn:ignore{{/code}} properties of some directories:
98
99 {{code language="none"}}
100 scripts/set_svn_ignore.sh
101 {{/code}}
102
103 ===== {{id name="PBA-cbsbootstrappingofportableC++project-Optional:Installrequiredlibsandbuildthepackage"/}}Optional: Install required libs and build the package =====
104
105 To produce the debian packages, just:
106
107 {{code language="none"}}
108 # this needs sudo privileges
109 pba-builddeps -i
110  
111 pba-build -u
112
113 # or dpkg-build*
114 {{/code}}
115
116 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.
117
118 ===== {{id name="PBA-cbsbootstrappingofportableC++project-Optional:CreateWindowsInstallers"/}}Optional: Create Windows Installers =====
119
120 (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:
121
122 {{code language="none"}}
123 $EDITOR src/*.nsi
124 {{/code}}
125
126 Then "make" the {{code language="none"}}nsis{{/code}} directory:
127
128 {{code language="none"}}
129 make -C nsis && ls -ltr nsis/*.exe
130 {{/code}}