Skip to Content
Last modified by christoph_lechleitner@iteg_at on 2018-01-03 03.50:49
From version 16.1
edited by christoph_lechleitner@iteg_at
on 2014-08-04 09.23:20
Change comment: Mentioning Multi-Module variant
To 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

Summary

Details

Page properties
Title
... ... @@ -1,1 +1,1 @@
1 -PBA-cbs bootstrapping of portable C++ project
1 +PBA-cbs bootstrapping of portable C/C++ project
Content
... ... @@ -1,159 +1,5 @@
1 -Setting up a portable C++ project still is a pain in the ass, especially if it shall be portable.
1 +I am preparing a full example to be checked out or exported from public svn.
2 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.
3 +Soon ...
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 -# for a flat application project:
27 -svn export "https://svn.clazzes.org/svn/pba/trunk/pba-helloworld-portable" $MYAPPNAME
28 -
29 -# for a multi-module multi-program application project:
30 -svn export "https://svn.clazzes.org/svn/pba/trunk/pba-hellobigworld-portable" $MYAPPNAME
31 - 
32 -# for a library project:
33 -svn export "https://svn.clazzes.org/svn/pba/trunk/pba-hellolib-portable" $MYAPPNAME
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
44 - 
45 -rm scripts/rename_main_files.sh
46 -{{/code}}
47 -
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 -(((
53 53  
54 -
55 -{{code language="none"}}
56 -# Variant 1: Remove NSIS installer only. For libraries common despite cross compilation.
57 -rm -rf nsis src/*.nsi
58 - 
59 -# Variant 2: Remove all windows crossbuilding stuff
60 -rm -rf nsis src/*.nsi src/include-mingw.mk src/*.rc debian-mingw* build/win*
61 -$EDITOR build/Makefile
62 -{{/code}}
63 -
64 -===== {{id name="PBA-cbsbootstrappingofportableC++project-Adaptdebianpackagemetainfos"/}}(% style="color: rgb(112,112,112);" %)Adapt debian package meta infos(%%) =====
65 -)))
66 -
67 -Change my name and e-mail to yours and adapt the description:
68 -
69 -{{code language="none"}}
70 -$EDITOR debian*/control debian*/changelog $(ls -1 src/*.pc.tmpl src/*.rc src/*.nsi src/*.h 2>/dev/null)
71 -{{/code}}
72 -
73 -(% style="color: rgb(51,51,51);" %)Do not forget to change the icon, too!
74 -
75 -===== {{id name="PBA-cbsbootstrappingofportableC++project-UpdateorremovetheReadMe"/}}Update or remove the ReadMe =====
76 -
77 -At least remove the link to this page ...
78 -
79 -{{code language="none"}}
80 -# edit ...
81 -$EDITOR doc/ReadMe.txt
82 - 
83 -# ... or remove the file and the reference in debian*/rules
84 -rm doc/ReadMe.txt
85 -$EDITOR debian*/rules
86 -{{/code}}
87 -
88 -===== {{id name="PBA-cbsbootstrappingofportableC++project-Optional:Activatesvnoranotherrevisioncontrolsystem"/}}(% style="line-height: 1.6666666;" %)Optional: Activate svn or another revision control system(%%) =====
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"}}
93 -svn add `pwd`
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 -
102 -===== {{id name="PBA-cbsbootstrappingofportableC++project-Optional:Installrequiredlibsandbuildthepackage"/}}Optional: Install required libs and build the package =====
103 -
104 -To produce the debian packages, just:
105 -
106 -{{code language="none"}}
107 -# this needs sudo privileges
108 -pba-builddeps -i
109 - 
110 -pba-build -u
111 -
112 -# or dpkg-build*
113 -{{/code}}
114 -
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.
116 -
117 -===== {{id name="PBA-cbsbootstrappingofportableC++project-Optional:CreateWindowsInstallers"/}}Optional: Create Windows Installers =====
118 -
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:
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}}
130 -
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 -
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}}
Confluence.Code.ConfluencePageClass[0]
Id
... ... @@ -1,1 +1,1 @@
1 -659179
1 +659171
Title
... ... @@ -1,1 +1,1 @@
1 -PBA-cbs bootstrapping of portable C++ project
1 +PBA-cbs bootstrapping of portable C/C++ project
URL
... ... @@ -1,1 +1,1 @@
1 -https://clazzes.atlassian.net/wiki/spaces/PBA/pages/659179/PBA-cbs bootstrapping of portable C++ project
1 +https://clazzes.atlassian.net/wiki/spaces/PBA/pages/659171/PBA-cbs bootstrapping of portable C/C++ project