~ubuntu-branches/ubuntu/saucy/texworks/saucy : revision 11

1

<!DOCTYPE html>

2

<html>

3

<head>

4

5

6

7

</head>

8

<body>

9

10

11

12

13

14

15

<a id="title" href="#top"><h1>CMake/packaging/mac/MacPackagingTasks.cmake.in</h1></a>

16

17

18

19

About

20

</div>

21

22

This documentation was built using Ryan Tomayko's Rocco tool:

23

<a href="http://rtomayko.github.com/rocco">rtomayko.github.com/rocco</a>

24

25

Which is based on Docco by Jeremy Ashkenas:

26

<a href="http://jashkenas.github.com/docco">jashkenas.github.com/docco</a>

27

28

The code from this navigation bar was borrowed from the CoffeeScript project, also by Jeremy:

29

<a href="http://jashkenas.github.com/coffee-script">jashkenas.github.com/coffee-script</a>

30

31

The templates used to create this page may be found on GitHub:

32

<a href="http://github.com/Sharpie/TeXworks/tree/master/CMake/docs">github.com/Sharpie/TeXworks</a>

33

34

</div>

35

</div>

36

37

38

39

Browse Source

40

</div>

41

42

<a class="source" href="../CMakeLists.html">CMake/packaging/CMakeLists.txt</a>

43

<a class="source" href="MacPackagingTasks.cmake.html">CMake/packaging/mac/MacPackagingTasks.cmake.in</a>

44

<a class="source" href="../../../CMakeLists.html">CMakeLists.txt</a>

45

<a class="source" href="../../../plugins-src/TWLuaPlugin/CMakeLists.html">plugins-src/TWLuaPlugin/CMakeLists.txt</a>

46

<a class="source" href="../../../plugins-src/TWPythonPlugin/CMakeLists.html">plugins-src/TWPythonPlugin/CMakeLists.txt</a>

47

<a class="source" href="../../../src/CMakeLists.html">src/CMakeLists.txt</a>

48

</div>

49

</div>

50

51

</div>

52

53

54

55

56

57

<thead>

58

<tr>

59

<th class=docs><h1>CMake/packaging/mac/MacPackagingTasks.cmake.in</h1></th>

60

61

</tr>

62

</thead>

63

<tbody>

64

<tr>

65

66

67

68

69

</div>

70

OS X packaging tasks

71

</td>

72

73

74

</td>

75

</tr>

76

<tr>

77

78

79

80

81

</div>

82

This file is processed by <code>CONFIGURE_FILE</code> in <code>../CMakeLists.txt</code> which inserts

83

values for <code>@VARIABLE@</code> declarations. This is done to import values for some

84

variables that would otherwise be undefined when CPack is running.

85

</td>

86

87

<div class='highlight'><pre>SET(PROJECT_NAME @PROJECT_NAME@)

88

SET(PROJECT_SOURCE_DIR @PROJECT_SOURCE_DIR@)

89

SET(PROJECT_BINARY_DIR @PROJECT_BINARY_DIR@)

90

SET(TeXworks_LIB_DIRS @TeXworks_LIB_DIRS@)

91

SET(CMAKE_SHARED_LIBRARY_SUFFIX @CMAKE_SHARED_LIBRARY_SUFFIX@)

92

SET(QT_PLUGINS @QT_PLUGINS@)</pre></div>

93

</td>

94

</tr>

95

<tr>

96

97

98

99

100

</div>

101

This <code>IF</code> statement ensures that the following commands are executed only when

102

CPack is running—-i.e. when a user executes <code>make package</code> but not <code>make install</code>

103

</td>

104

105

<div class='highlight'><pre>IF ( ${CMAKE_INSTALL_PREFIX} MATCHES .*/_CPack_Packages/.* )</pre></div>

106

</td>

107

</tr>

108

<tr>

109

110

111

112

113

</div>

114

<h2>Download and install Poppler data</h2>

115

</td>

116

117

<div class='highlight'><pre> IF ( NOT EXISTS ${PROJECT_SOURCE_DIR}/poppler-data-0.4.4.tar.gz )

118

MESSAGE(STATUS "Downloading Poppler data files")

119

FILE(DOWNLOAD "http://poppler.freedesktop.org/poppler-data-0.4.4.tar.gz"

120

${PROJECT_SOURCE_DIR}/poppler-data-0.4.4.tar.gz

121

EXPECTED_MD5 f3a1afa9218386b50ffd262c00b35b31

122

SHOW_PROGRESS

123

)

124

ENDIF ()

125

126

IF ( NOT EXISTS ${PROJECT_SOURCE_DIR}/poppler-data-0.4.4 )

127

EXECUTE_PROCESS(COMMAND tar xzf ${PROJECT_SOURCE_DIR}/poppler-data-0.4.4.tar.gz

128

WORKING_DIRECTORY ${PROJECT_SOURCE_DIR}

129

)

130

ENDIF ()

131

132

FILE(INSTALL ${PROJECT_SOURCE_DIR}/poppler-data-0.4.4/

133

DESTINATION ${CMAKE_INSTALL_PREFIX}/${PROJECT_NAME}.app/Contents/poppler-data

134

PATTERN CMakeLists.txt EXCLUDE

135

PATTERN Makefile EXCLUDE

136

)</pre></div>

137

</td>

138

</tr>

139

<tr>

140

141

142

143

144

</div>

145

<h2>Download and install TeXworks manual</h2>

146

</td>

147

148

<div class='highlight'><pre> IF ( NOT EXISTS ${PROJECT_SOURCE_DIR}/TeXworks-manual-html-r814.zip )

149

MESSAGE(STATUS "Downloading TeXworks HTML manual")

150

FILE(DOWNLOAD "http://texworks.googlecode.com/files/TeXworks-manual-html-r814.zip"

151

${PROJECT_SOURCE_DIR}/TeXworks-manual-html-r814.zip

152

EXPECTED_MD5 2894969a6ac4bba31953264e04553717

153

SHOW_PROGRESS

154

)

155

ENDIF ()

156

157

IF ( NOT EXISTS ${PROJECT_SOURCE_DIR}/TeXworks-manual )

158

EXECUTE_PROCESS(COMMAND unzip ${PROJECT_SOURCE_DIR}/TeXworks-manual-html-r814.zip

159

WORKING_DIRECTORY ${PROJECT_SOURCE_DIR}

160

)

161

ENDIF ()

162

163

FILE(INSTALL ${PROJECT_SOURCE_DIR}/TeXworks-manual

164

DESTINATION ${CMAKE_INSTALL_PREFIX}/${PROJECT_NAME}.app/Contents/texworks-help/

165

)</pre></div>

166

</td>

167

</tr>

168

<tr>

169

170

171

172

173

</div>

174

<h2>Copy all runtime dependencies and rewrite loader paths</h2>

175

</td>

176

177

178

</td>

179

</tr>

180

<tr>

181

182

183

184

185

</div>

186

Bring in <code>DeployQt4</code> a CMake module taken from the Charm application:

187

188

<a href="https://github.com/KDAB/Charm">https://github.com/KDAB/Charm</a>

189

190

This module offers the <code>FIXUP_QT4_BUNDLE</code> function which wraps

191

<code>FIXUP_BUNDLE</code> from CMake’s <code>BundleUtilities</code> module and extends it with

192

additional Qt4-specific goodies—-such as installing Qt4 plugins.

193

194

<code>FIXUP_BUNDLE</code> is a wonderful function that examines an executable, finds

195

all non-system libraries it depends on, copies them into the <code>.app</code> bundle

196

and then re-writes the necessary loader paths.

197

</td>

198

199

<div class='highlight'><pre> SET(CMAKE_MODULE_PATH @CMAKE_MODULE_PATH@)

200

INCLUDE(DeployQt4)</pre></div>

201

</td>

202

</tr>

203

<tr>

204

205

206

207

208

</div>

209

Gather all TeXworks Plugin libraries.

210

</td>

211

212

<div class='highlight'><pre> FILE(GLOB TeXworks_PLUGINS

213

${CMAKE_INSTALL_PREFIX}/${PROJECT_NAME}.app/Contents/PlugIns/*${CMAKE_SHARED_LIBRARY_SUFFIX})</pre></div>

214

</td>

215

</tr>

216

<tr>

217

218

219

220

221

</div>

222

If <code>BU_CHMOD_BUNDLE_ITEMS</code> is not set, <code>install_name_tool</code> will fail to

223

re-write some loader paths due to insufficiant permissions.

224

</td>

225

226

<div class='highlight'><pre> SET(BU_CHMOD_BUNDLE_ITEMS ON)

227

228

FIXUP_QT4_BUNDLE(${CMAKE_INSTALL_PREFIX}/${PROJECT_NAME}.app "${QT_PLUGINS}" "${TeXworks_PLUGINS}" "${TeXworks_LIB_DIRS}")</pre></div>

229

</td>

230

</tr>

231

<tr>

232

233

234

235

236

</div>

237

<h2>Remove unecessary architectures from universal binaries</h2>

238

</td>

239

240

241

</td>

242

</tr>

243

<tr>

244

245

246

247

248

</div>

249

Some libraries copied from the OS X system, such as X11 libraries, may

250

contain up to 4 different architectures. Here we will iterate over these

251

libraries and use <code>lipo</code> to strip out un-needed architectures.

252

</td>

253

254

255

</td>

256

</tr>

257

<tr>

258

259

260

261

262

</div>

263

Another useful function from <code>BundleUtilities</code>.

264

</td>

265

266

<div class='highlight'><pre> GET_BUNDLE_MAIN_EXECUTABLE(${CMAKE_INSTALL_PREFIX}/${PROJECT_NAME}.app APP_MAIN)</pre></div>

267

</td>

268

</tr>

269

<tr>

270

271

272

273

274

</div>

275

We look at the TeXworks binary that was built rather than consulting the

276

value of the <code>CMAKE_OSX_ARCHITECTURES</code> because if the user did not set

277

<code>CMAKE_OSX_ARCHITECTURES</code>, then the variable will be an empty string and the

278

format of the resulting binary will depend on the versions of OS X and

279

XCode.

280

</td>

281

282

<div class='highlight'><pre> MESSAGE(STATUS "Reducing the size of bundled libraries.")

283

MESSAGE(STATUS "Scanning architectures of: ${APP_MAIN}")

284

EXECUTE_PROCESS(</pre></div>

285

</td>

286

</tr>

287

<tr>

288

289

290

291

292

</div>

293

<code>lipo -info</code> returns a list of the form:

294

295

296

</code></pre>

297

298

Piping this output to <code>cut -d : -f 3-</code> allows us to extract just the list

299

of architectures.

300

</td>

301

302

<div class='highlight'><pre> COMMAND lipo -info ${APP_MAIN}

303

COMMAND cut -d : -f 3-

304

OUTPUT_VARIABLE APP_ARCHS

305

)</pre></div>

306

</td>

307

</tr>

308

<tr>

309

310

311

312

313

</div>

314

Strip leading and trailing whitespace.

315

</td>

316

317

<div class='highlight'><pre> STRING(STRIP ${APP_ARCHS} APP_ARCHS)</pre></div>

318

</td>

319

</tr>

320

<tr>

321

322

323

324

325

</div>

326

Convert spaces to semicolons so CMake will interpret the string as a list.

327

</td>

328

329

<div class='highlight'><pre> STRING(REPLACE " " ";" APP_ARCHS ${APP_ARCHS})

330

331

MESSAGE(STATUS "Will reduce bundled libraries to: ${APP_ARCHS}")

332

333

FOREACH(ARCH IN LISTS APP_ARCHS)

334

SET(ARCHS_TO_EXTRACT "${ARCHS_TO_EXTRACT} -extract ${ARCH}")

335

ENDFOREACH ()</pre></div>

336

</td>

337

</tr>

338

<tr>

339

340

341

342

343

</div>

344

NOTE: This will not process any dylibs from Frameworks copied by

345

<code>FIXUP_BUNDLE</code>, hence it may not touch any of the Qt libraries. Something to

346

fix in the future.

347

</td>

348

349

<div class='highlight'><pre> FILE(GLOB BUNDLED_DYLIBS

350

${CMAKE_INSTALL_PREFIX}/${PROJECT_NAME}.app/Contents/MacOS/*${CMAKE_SHARED_LIBRARY_SUFFIX})

351

352

FOREACH(DYLIB IN LISTS BUNDLED_DYLIBS)

353

MESSAGE(STATUS "Processing included library: ${DYLIB}")</pre></div>

354

</td>

355

</tr>

356

<tr>

357

358

359

360

361

</div>

362

<code>lipo</code> is very very anal about how arguments get passed to it. So we

363

execute through bash to side-step the issue.

364

365

</td>

366

367

<div class='highlight'><pre> EXECUTE_PROCESS(COMMAND bash -c "lipo ${ARCHS_TO_EXTRACT} ${DYLIB} -output ${DYLIB}")

368

ENDFOREACH ()

369

370

MESSAGE(STATUS "Finished stripping architectures from bundled libraries.")

371

372

ENDIF ()</pre></div>

373

</td>

374

</tr>

375

</table>

376

</div>

377

378

379

380

381

var closeMenus;

382

closeMenus = function() {

383

return $('.navigation.active').removeClass('active');

384

};

385

$('.navigation').click(function(e) {

386

if (e.target.tagName.toLowerCase() === 'a') {

387

return;

388

}

389

if ($(e.target).closest('.repl_wrapper').length) {

390

return false;

391

}

392

if ($(this).hasClass('active')) {

393

closeMenus();

394

} else {

395

closeMenus();

396

$(this).addClass('active');

397

}

398

return false;

399

});

400

</script>

401

402

</body>

403

</html>