OSDN Git Service

ProgressDlg: Changed 'OK' into 'Close' and 'Cancel' into 'Abort'
[tortoisegit/TortoiseGitJp.git] / doc / build-zh_CN.txt
1 首先,你需要安装编译器软件。
2
3 A.  你需要 VS.NET2005 (或者至少 Visual C++ .NET 2005) 构建全部 TortoiseSVN
4     软件包。这是推荐选项,但不是免费的 :-(
5     如果你需要构建 msi 安装包,确认已经安装 “Tools for Redistributing
6     Applications”。
7
8 B.  如果没有 VS.NET,你可以下载免费的 Visual C++ 2005 Express。它只能构建
9     Git 库,SubWCRev,TortoiseBlame 和 TortoiseIDiff 程序。
10     - 安装 Visual C++ 2005 Express 版本。
11       下载地址: http://msdn.microsoft.com/vstudio/express/visualc/
12     - 安装 Microsoft Platform SDK,版本是 Windows Server 2003 SP1
13       你至少要安装 SDK 中的以下组件:
14         - Windows Core SDK
15         - Web Workshop (IE) SDK
16         - Data Access Services
17         - Debugging Tools
18     - 安装 MASM 6.15,下载地址: http://win32assembly.online.fr/files/masm615.zip
19       将它增加到环境变量 PATH 中。
20     不要为安装 WiX 烦恼,因为你不能构建那么多软件。
21
22 C.  如果你计划构建 64 位软件包,请安装软件包
23     - 在 VS.NET2005 专业版或更高版本中的 "Language Tools" -> "Visual C++"
24       -> "X64 Compilers and Tools"
25       它会为你提供交叉编译器,以及适当的命令行环境。在 XP64 中,还会有一个本机编译器。
26     - x64 SDK (在 Windows Server 2003 Platform SDK 中有,可以从
27       http://www.microsoft.com/downloads 免费下载) 或许可用,但是尚未测试。
28
29 下一步,你需要安装一些工具/程序:
30 - Java runtime            : http://java.sun.com, http://java.sun.com/webapps/getjava/BrowserRedirect
31 - Python 2.4(*)           : http://www.python.org/windows/
32 - libxml2 python bindings : http://users.skynet.be/sbi/libxml-python/
33 - Perl                    : http://www.activestate.com/Products/ActivePerl/
34 - WiX(*)                  : http://wix.sourceforge.net
35 - NAnt(*)                 : http://nant.sourceforge.net
36 - gdiplus merge module(#) : http://www.installshield.com/downloads/modules.asp?prod=ISX&lan=english&xmlUse=y
37
38 (*) 将这些可执行程序/动态库的路径增加到环境变量 PATH 中。
39     为了让新的环境变量生效,你可能需要重新登录!
40
41 (#) 将文件 gdiplus.msm 复制/移动到目录 "%CommonProgramFiles%\Merge Modules" 中。
42
43
44 下一步,你需要下载:
45 - OpenSSL source          : http://www.openssl.org/source/
46 - ZLib source             : http://www.gzip.org/zlib/
47 - tools collection        : http://tortoisesvn.tigris.org/files/documents/406/37871/Tools.zip
48 - dictionaries/thesauri   : http://lingucomponent.openoffice.org/
49
50 现在你几乎准备完毕。只需要做以下步骤:
51 - 在你的硬盘上创建新目录,例如 SVN。确认你最少有 1.5 GB 剩余空间!!!
52 - 在目录 SVN 中创建新目录 “common”。
53 - 在目录 “common” 中解压 openssl 源代码,改名为 “openssl”。
54 - 在目录 “common” 中解压 zlib 源代码,改名为 “zlib”。
55 - 将 dictionaries/thesauri 复制到 “common\spell”。
56   注意文件名称很重要!必须为 en_US.aff,en_US.dic,en_GB.aff 和 en_GB.dic (或者你使用的其它语言)。
57   警告: 只支持词典格式 OO2。早期版本会让 TortoiseSVN 崩溃!
58 - 从 Git 版本库将 TortoiseSVN 源代码检出到目录 SVN\TortoiseSVN。
59 - 解压文件 “tools.zip”,建议目录是 “SVN\TortoiseSVN\Tools”。
60   注视: 目录 tools 的路径不能包含特殊字符或空格。如果你将TortoiseSVN 源代码
61   检出到这样的位置,你可以将目录 tools 存放到其它合适的位置。
62 - 将位于 TSVN 根目录的文件 default.build.user.tmpl 复制到
63   default.build.user。然后调整文件中使用的路径。
64 - 将文件 doc\doc.build.user.tmpl 复制到 doc\doc.build.user。然后按照
65   设置调整文件中使用的路径。
66 - 某些语言的文档需要特别的配置。如果在目录 doc\xsl\languagecode\ 有文件
67   “userconfig.template.xml”,那么将其复制到 “userconfig.xml”,然后按照你的
68   OS 配置调整文件中的路径。
69
70
71 构建 32 位软件包
72
73   提示: 在构建 TortoiseSVN之前,你需要调用目录 %VS80COMNTOOLS% 中的文件
74   vsvars32.bat。如果你不想每次都这么做,你可以让命令行窗口自动调用此文件:
75   - 创建一个包含以下内容的 .reg 文件,合并到你的注册表。
76     Windows Registry Editor Version 5.00
77
78     [HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Command Processor]
79     "AutoRun"="\"C:\\Program Files\\Microsoft Visual Studio 8\\Common7\\Tools\\vsvars32.bat\""
80   你下次启动命令行窗口时,这个文件会被自动执行。
81
82   注意 Express 版本需要为 Platform SDK 设置变量。我发现的最简单的方法是编辑 VC++ 提供的文件
83   C:\Program Files\Microsoft Visual Studio 8\VC\vcvarsall.bat
84   查找标签 :x86,增加对 setenv.cmd 的调用:
85
86     :x86
87     if not exist "%~dp0bin\vcvars32.bat" goto missing
88     call "%~dp0bin\vcvars32.bat"
89     rem Added SDK setup 14/12/2005 SJL
90     call "C:\Program Files\Microsoft Platform SDK\setenv.cmd"
91     goto :eof
92
93   然后与上述调用 vsvars32 类似,在启动命令行窗口时自动调用 vsvarsall.bat。
94
95   现在,如果你还有时间的话,可以运行构建脚本编译 TortoiseSVN。拿一杯咖啡 - 依赖
96   于你的计算机速度(我的机器需要 1 小时 50 分钟),它可能需要两个小时!
97
98   > nant
99   会显示你可用的目标的帮助信息
100
101   > nant setup
102   会编译一切,板含文档和语言包,创建 msi 安装程序
103
104   注意: 当构建脚本编译 Git 时,你可能看到一些编译错误,例如:
105   > error C2065: 'SVN_FS_WANT_DB_MAJOR' : undeclared identifier
106   > error C2065: 'SVN_FS_WANT_DB_MINOR' : undeclared identifier
107   > error C2065: 'SVN_FS_WANT_DB_PATCH' : undeclared identifier
108   这是正常的,无须担忧。这些错误的原因是 TortoiseSVN 构建两次 Git 库。
109   一次构建所有 RA 访问层和所有库,另一次没有这些构建。这些错误在 “原始” 构建
110   中出现,但是这些库不在此构建中使用。当然,构建脚本可以调整为只构建真正需要
111   的库,但是与构建全部相比,构建独立的工程并不容易。
112   如果你愿意改进构建脚本,摆脱这些错误,欢迎与我们联系!
113
114   如果你使用 VC++ Express 构建,你的选项稍微受限。首先在 default.build.user 中
115   修改构建工具。它已经设置好了,你只需要去掉注视即可:
116
117     <property name="buildtool" value="vcexpress.exe" />
118
119   现在你需要构建 Git 库:
120   > nant Git
121
122   注意 VC Express 编译器在后台工作,没有控制台窗口。它有大量的磁盘操作,但是在
123   Nant 控制台窗口没有结果显示。请耐心等候!
124
125   在构建应用程序之前,更新版本信息:
126   > nant VersionInfo
127
128   现在你可以用打开文件 SubWCRev.vcproj 的方法启动 IDE。可能会出现一些错误对话
129   框,你可以忽略。右击 SubWCRev,选择 “Build”。
130
131   你也可以右击 TortoiseBlame,然后构建。
132
133 在 win32 中构建 64 位软件包(交叉编译)
134
135   首先,我们需要一些在构建时用到的 32 位 SVN 工具。按照上述指示,或者打开
136   "Microsoft Visual Studio 2005" -> "Visual Studio Tools" ->
137   "Visual Studio 2005 Command Prompt",切换到 TSVN 源代码目录,运行
138
139     nant release binaries
140
141   现在,构建 x64 软件包: 打开
142   "Microsoft Visual Studio 2005" -> "Visual Studio Tools" ->
143   "Visual Studio 2005 x64 Cross Tools Command Prompt",切换到 TSVN 源代码目录,
144   运行
145
146     nant x64 cross release setup
147
148   在脚本结束后,可以在目录 .\bin 找到软件包。
149
150
151 在 x64 中构建 64 位软件包
152
153   为了在 64 位 Windows 中构建本机软件包,打开
154   "Microsoft Visual Studio 2005" -> "Visual Studio Tools" ->
155   "Visual Studio 2005 Win64 Command Prompt",切换到 TSVN 源代码目录,运行
156
157     nant x64 release setup
158
159   在脚本结束后,可以在目录 .\bin 找到软件包。