Skip to Content
Version 9.1 by christoph_lechleitner@iteg_at on 2014-01-02 03.27:43
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"}}
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
christoph_lechleitner@iteg_at 6.1 37  
38 rm scripts/rename_main_files.sh
christoph_lechleitner@iteg_at 2.1 39 {{/code}}
40
christoph_lechleitner@iteg_at 9.1 41 ===== {{id name="PBA-cbsbootstrappingofportableC++project-Optional:Removewindowsstuff"/}}Optional: Remove windows stuff =====
42
43 If you do not want windows binaries, remove it:
44
45 (((
46 {{code language="none"}}
47 rm -rf src/include-mingw.mk src/*.nsi src/*.rc debian-mingw* build/win* nsis
48 {{/code}}
49 )))
50
christoph_lechleitner@iteg_at 4.1 51 ===== {{id name="PBA-cbsbootstrappingofportableC++project-Adaptdebianinformation"/}}Adapt debian information =====
christoph_lechleitner@iteg_at 2.1 52
christoph_lechleitner@iteg_at 4.1 53 Change my name and e-mail to yours and adapt the description:
christoph_lechleitner@iteg_at 2.1 54
55 {{code language="none"}}
56 $EDITOR debian*/control debian*/changelog
57 {{/code}}
58
christoph_lechleitner@iteg_at 4.1 59 ===== {{id name="PBA-cbsbootstrappingofportableC++project-Optional:AdapttheWindowsrctemplate..."/}}Optional: Adapt the Windows rc template ... =====
christoph_lechleitner@iteg_at 2.1 60
christoph_lechleitner@iteg_at 9.1 61 If you want windows binaries, edit the templates for .rc file and NSIS installer script:
christoph_lechleitner@iteg_at 2.1 62
63 {{code language="none"}}
christoph_lechleitner@iteg_at 9.1 64 $EDITOR src/*.rc src/*.nsi
christoph_lechleitner@iteg_at 2.1 65 {{/code}}
66
67 Do not forget to change the icon, too!
68
christoph_lechleitner@iteg_at 9.1 69 ===== {{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 70
71 Now (and before any build activity) is a very good time to put your project under subversion control:
72
73 {{code language="none"}}
christoph_lechleitner@iteg_at 4.1 74 svn add `pwd`
christoph_lechleitner@iteg_at 2.1 75 {{/code}}
76
77 You might also want to fill {{code language="none"}}svn:ignore{{/code}} properties of some directories:
78
79 {{code language="none"}}
80 scripts/set_svn_ignore.sh
81 {{/code}}
82
christoph_lechleitner@iteg_at 4.1 83 ===== {{id name="PBA-cbsbootstrappingofportableC++project-Optional:Installrequiredlibsandbuildthepackage"/}}Optional: Install required libs and build the package =====
christoph_lechleitner@iteg_at 2.1 84
christoph_lechleitner@iteg_at 4.1 85 To produce the debian packages, just:
christoph_lechleitner@iteg_at 2.1 86
87 {{code language="none"}}
christoph_lechleitner@iteg_at 4.1 88 # this needs sudo privileges
89 pba-builddeps -i
90  
christoph_lechleitner@iteg_at 2.1 91 pba-build -u
christoph_lechleitner@iteg_at 4.1 92
christoph_lechleitner@iteg_at 2.1 93 # or dpkg-build*
94 {{/code}}
95
christoph_lechleitner@iteg_at 4.1 96 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 97
christoph_lechleitner@iteg_at 5.1 98 ===== {{id name="PBA-cbsbootstrappingofportableC++project-Optional:CreateWindowsInstallers"/}}Optional: Create Windows Installers =====
christoph_lechleitner@iteg_at 2.1 99
christoph_lechleitner@iteg_at 5.1 100 First, 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:
101
102 {{code language="none"}}
103 $EDITOR src/*.nsi
104 {{/code}}
105
106 Then "make" the {{code language="none"}}nsis{{/code}} directory:
107
108 {{code language="none"}}
109 make -C nsis && ls -ltr nsis/*.exe
110 {{/code}}
111
christoph_lechleitner@iteg_at 7.1 112 ===== {{id name="PBA-cbsbootstrappingofportableC++project-FinallyupdatetheReadMe"/}}Finally update the ReadMe =====
christoph_lechleitner@iteg_at 5.1 113
christoph_lechleitner@iteg_at 9.1 114 At least remove the link to this page ...
christoph_lechleitner@iteg_at 7.1 115
116 {{code language="none"}}
117 $EDITOR doc/ReadMe.txt
118 {{/code}}
christoph_lechleitner@iteg_at 9.1 119
120 ... or the complete ReadMe file.