Skip to Content
Last modified by christoph_lechleitner@iteg_at on 2018-01-03 03.50:49
From version 1.1
edited by christoph_lechleitner@iteg_at
on 2012-07-20 05.08:42
Change comment: There is no comment for this version
To version 8.1
edited by christoph_lechleitner@iteg_at
on 2012-07-22 02.17:53
Change comment: Migrated to Confluence 5.3

Summary

Details

Page properties
Title
... ... @@ -1,1 +1,1 @@
1 -PBA-cbs bootstrapping of portable C/C++ project
1 +PBA-cbs bootstrapping of portable C++ project
Content
... ... @@ -1,5 +1,120 @@
1 -I am preparing a full example to be checked out or exported from public svn.
1 +Setting up a portable C++ project still is a pain in the ass, especially if it shall be portable.
2 2  
3 -Soon ...
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 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 + 
38 +rm scripts/rename_main_files.sh
39 +{{/code}}
40 +
41 +===== {{id name="PBA-cbsbootstrappingofportableC++project-Adaptdebianinformation"/}}Adapt debian information =====
42 +
43 +Change my name and e-mail to yours and adapt the description:
44 +
45 +{{code language="none"}}
46 +$EDITOR debian*/control debian*/changelog
47 +{{/code}}
48 +
49 +===== {{id name="PBA-cbsbootstrappingofportableC++project-Optional:AdapttheWindowsrctemplate..."/}}Optional: Adapt the Windows rc template ... =====
50 +
51 +If you want windows binaries, edit the resoure template:
52 +
53 +{{code language="none"}}
54 +$EDITOR src/*.rc
55 +{{/code}}
56 +
57 +Do not forget to change the icon, too!
58 +
59 +===== {{id name="PBA-cbsbootstrappingofportableC++project-Alternatively:Removewindowsstuff"/}}Alternatively: Remove windows stuff =====
60 +
61 +If you do not want windows binaries, remove it:
62 +
63 +(((
5 5  
65 +
66 +{{code language="none"}}
67 +rm -rf src/include-mingw.mk src/*.rc debian-mingw* build/win*
68 +{{/code}}
69 +
70 +===== {{id name="PBA-cbsbootstrappingofportableC++project-Optional:Activatesvnoranotherrevisioncontrolsystem"/}}Optional: Activate svn or another revision control system =====
71 +)))
72 +
73 +Now (and before any build activity) is a very good time to put your project under subversion control:
74 +
75 +{{code language="none"}}
76 +svn add `pwd`
77 +{{/code}}
78 +
79 +You might also want to fill {{code language="none"}}svn:ignore{{/code}} properties of some directories:
80 +
81 +{{code language="none"}}
82 +scripts/set_svn_ignore.sh
83 +{{/code}}
84 +
85 +===== {{id name="PBA-cbsbootstrappingofportableC++project-Optional:Installrequiredlibsandbuildthepackage"/}}Optional: Install required libs and build the package =====
86 +
87 +To produce the debian packages, just:
88 +
89 +{{code language="none"}}
90 +# this needs sudo privileges
91 +pba-builddeps -i
92 + 
93 +pba-build -u
94 +
95 +# or dpkg-build*
96 +{{/code}}
97 +
98 +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.
99 +
100 +===== {{id name="PBA-cbsbootstrappingofportableC++project-Optional:CreateWindowsInstallers"/}}Optional: Create Windows Installers =====
101 +
102 +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:
103 +
104 +{{code language="none"}}
105 +$EDITOR src/*.nsi
106 +{{/code}}
107 +
108 +Then "make" the {{code language="none"}}nsis{{/code}} directory:
109 +
110 +{{code language="none"}}
111 +make -C nsis && ls -ltr nsis/*.exe
112 +{{/code}}
113 +
114 +===== {{id name="PBA-cbsbootstrappingofportableC++project-FinallyupdatetheReadMe"/}}Finally update the ReadMe =====
115 +
116 +At least remove the link to this page:
117 +
118 +{{code language="none"}}
119 +$EDITOR doc/ReadMe.txt
120 +{{/code}}
Confluence.Code.ConfluencePageClass[0]
Id
... ... @@ -1,1 +1,1 @@
1 -659171
1 +659170
Title
... ... @@ -1,1 +1,1 @@
1 -PBA-cbs bootstrapping of portable C/C++ project
1 +PBA-cbs bootstrapping of portable C++ project
URL
... ... @@ -1,1 +1,1 @@
1 -https://clazzes.atlassian.net/wiki/spaces/PBA/pages/659171/PBA-cbs bootstrapping of portable C/C++ project
1 +https://clazzes.atlassian.net/wiki/spaces/PBA/pages/659170/PBA-cbs bootstrapping of portable C++ project