-
Notifications
You must be signed in to change notification settings - Fork 0
/
INSTALL
72 lines (59 loc) · 2.73 KB
/
INSTALL
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
Introduction
============
The iTCH project consists of two separate applications:
- An iTunes plug-in for Windows
- A multi-platform client application
The iTunes plug-in can only be built on Windows, while the
client application can be compiled for both Windows and
Linux/UNIX operating systems. The build system is setup
so that the plug-in code is ignored for non-Windows systems.
The installation instructions describe the process for building
both plug-in and client application. Instructions for building
the plug-in application should be ignored when not working on
Windows.
Prerequisites
=============
Building the iTCH software requires the following applications
and libraries:
- CMake cross-platform, open-source build system:
http://www.cmake.org
- Qt cross-platform application and UI framework, version 4.6 or greater:
http://qt.nokia.com
- Protocol Buffers library:
http://code.google.com/p/protobuf/
- iTunes COM for Windows SDK (for Windows builds only):
http://connect.apple.com
Access to the iTunes COM for Windows SDK requires a free Apple
Developer Connection (ADC) account, which can be created at the ADC
website (http://developer.apple.com). After creating an
account, go to http://connect.apple.com, click on the "Developer
Tools" link found in the Downloads menu. Then search for
"iTunes COM for Windows SDK" and download the associated zip
file.
Building the software
=====================
Preparing to build the client application or plug-in:
Before compiling the code, the Qt and Protocol Buffers libraries must
be installed. These can be compiled and installed from source, or
installed from pre-compiled binaries. Refer to the installation
instruction for both libraries for the appropriate installation
procedure.
Additional preparation for building the plug-in:
For Windows, After the Qt and Protocol Buffers dependencies are
installed, the "iTunes COM for Windows SDK" source code should be
added to the iTCH distribution. This is done by extracting the
directory found within the "iTunes COM for Windows SDK" zip file to
the root directory of the iTCH distribution. The "iTunes COM for
Windows SDK" directory should be named "iTunesCOMWindowsSDK".
Generating build files:
With the Qt and Protocol Buffers dependencies installed, and the
"iTunes COM for Windows SDK" source code copied to the root iTCH
directory (windows only), CMake should be used to generate the
appropriate build files for your preferred build environment.
You must specify the locations of the Qt and Protocol Buffers
header and library files as part of the CMake configuration
process.
Performing the build:
Once CMake has generated the build files for you build
environment, the iTCH programs can be built from within that
environment.