- Get the source code (download)

Download 받은 source는 아래와 같은 방법으로 압축을 푼다.

이제부터 $SRC_ROOT를 OpenOffice.org source directory로 지칭하겠다. (여기서는 OOB680_m5)

- External Library

Build 환경이 갖추어 졌다고 해서 compile되지는 않는다. License 등의 문제로 source에서 빠진 외부 라이브러리를 source안에 설치해 줘야 한다.

• General Polygon Clipper Library (GPC) (download)
  압축을 풀어서 나온 gpc.c gpc.h를 $SRC_ROOT/external/gpc에 복사한다.
• Microsoft Layer for Unicode (download)
  unicows.dll을 $SRC_ROOT/external/unicows에 복사한다.
• dbghelp.dll (download)
  dbghelp.dll을 $SRC_ROOT/external/dbghelp에 복사한다.
• Mozilla Libraries (download)
  WNTMSCI{inc,lib,runtime}.zip을 받아서 $SRC_ROOT/moz/zipped에 복사한다.

- Generating the Build Environment and Build Tools

OpenOffice.org도 다른 Open Source program들과 마찬가지로 configure script로 build 환경을 check하고 준비하며, make로 build를 한다.

다만 특이한 것은 config_office directory에서 configure 를 실행해서 build 환경 check와 build 순서 file을 $SRC_ROOT에 생성한다. 그리고 생성된 파일을 가지고 OpenOffice.org source에 포함된 dmake를 가지고 빌드를 하게 되어있다. 한마디로 configure, make 유틸리티도 자기들에 맞게 수정해서 사용한다는 이야기다.

배경 설명은 이정도로 하고, 시작해 보자.

1. Cygwin shell을 시작한다. bash가 기본 shell로 되어 있을 것이다.
2. 압축을 해제한 directory로 이동한다.
3. config_office direcotry로 이동한다. 여기에 있는 configure script를 이용해서 실제 compile시에 사용할 configure script를 생성할 것이다.

   1	[$SRC_ROOT] cd config_office

4. configure script에 들어갈 인자가 많기 때문에 편하게 사용하기 위해서 shell script를 작성한다.

   1 2 3 4 5 6 7 8 9 10 11 12

   [$SRC_ROOT/config_office] vi configure_my.sh #!/bin/bash ./configure --with-jdk-home='/cygdrive/c/j2sdk1.4.2_11' \ --with-psdk-home='/cygdrive/c/Program Files/Microsoft Platform SDK' \ --with-directx-home='/cygdrive/c/DirectXSDK' \ --with-frame-home='/cygdrive/c/Program Files/Microsoft Visual Studio .NET 2003/SDK/v.1.1' \ --with-use-shell=tcsh \ --with-lang=ko \ --with-mspdb-path='/cygdrive/c/Program Files/Microsoft Visual Studio .NET 2003/Common7/IDE' \ --with-midl-path='/cygdrive/c/Program Files/Microsoft Visual Studio .NET 2003/Common7/Tools' \ --with-csc-path='/cygdrive/c/WINDOWS/Microsoft.NET/Framework/v1.1.4322' \ --with-cl-home='/cygdrive/c/Program Files/Microsoft Visual Studio .NET 2003/Vc7'

5. 작성했다면 저장하고 나온 후, 실행 permission을 주고 실행한다.

   1 2	[$SRC_ROOT/config_office] chmod 755 configure_my.sh [$SRC_ROOT/config_office] ./configure_my.sh

6. 성공적으로 script가 수행되었다면 $SRC_ROOT에 bootstrap, winenv.set file이 생성되었을 것이다. 그후에 다음을 실행한다.

   1 2 3 4 5 6 7 8

   [$SRC_ROOT/config_office] cd ../ [$SRC_ROOT] tcsh (build를 위해서 default shell인 bash를 사용하지 않고 tcsh를 사용한다.) [$SRC_ROOT] ./bootstrap (configure script를 통해서 만들어진 script로 OpenOffice.org를 build할 system의 환경을 체크하고, build시 사용할 dmake를 compile한다.) [$SRC_ROOT] source winenv.set (build에 필요한 환경 변수들을 설정한다.) [$SRC_ROOT] rehash

이제야 겨우 build 환경이 다 갖추어 졌다. 일단 여기까지 제대로 따라했다면 절반 이상은 성공한 것이나 다름없다.

5. Build Instructions

- Building a Full Build

전체 모든 source를 build하기 위해서는 다음을 입력한다.

build가 완료될 때까지 걸리는 시간은 원문에 나와있기를…

Architecture : Intel
Processor : Athlon XP1700
Processor speed : 1466 MHz
RAM : 512 MB
Hard Disk : 160 GB 7200 RPM IDE
Time : about 17 hour

테스트한 컴퓨터의 사양과 빌드시간은,

Architecture : Intel
Processor : Pentium 4
Processor speed : 2.66 GHz
RAM : 1GB
Hard Disk : 60 GB 7200 RPM IDE
Time : about 14 hour

결론은… 때려주고 싶을 정도로 오래 걸린다. ㅡㅡ;

Build가 error없이 성공했다면 아래의 directory에 MSI install package가 생성되어 있을 것이다. 실행하여 설치하자. 그럼 build는 끝..

- Building a Project with Debug Information

OpenOffice.org의 module을 debugging하고 싶으면 full build된 source에서 그 module만 debug mode로 build해서 사용한다.

왜 전체 module을 debug mode로 build하지 않는가? 이 질문에 대한 대답은 debug mode로 build하는 시간이 너무 오래 걸리고, 비효율적으로 OpenOffice.org가 실행이 되며, 사용공간을 많이 차지 한다는 것이다.

OpenOffice.org는 module화가 잘 되어있어서 굳이 필요없는 module을 debug mode로 compile할 필요 없이 필요한 module만 debug mode로 compile하면 debugging 할 수 있게 되어 있다.

6. Build Trouble Shooting

1) Cygwin의 bug

Cygwin의 bug로 인해서 build 중에 멈추는 현상이 있다. 이 문제를 해결하기 위해서는 build하고 있는 cygwin shell외에 하나 더 띄워서 다음과 같은 script를 만들어서 실행한다.

2) Build 중에 생기는 error들…

1. $SRC_ROOT/lingucomponent/source/spellcheck/hunspell/hunspell.cxx 에서 Sharp S 문자를 컴파일러에서 인식하지 못해서 에러가 발생한다. 발생하는 구문의 문자를 변경한다.
2. $SRC_ROOT/svx/wntmsci10.pro/inc/chinese_direction.hrc 에서 문자를 컴파일러에서 인식하지 못해서 에러가 발생한다. 발생하는 구문의 문자를 변경한다.
3. $SRC_ROOT/dbaccess/wntmsci10.pro/inc/AutoControls.hrc 에서 문자를 컴파일러에서 인식하지 못해서 에러가 발생한다. 발생하는 구문의 문자를 변경한다.

7. Files

위에서 Build를 위해 사용하거나 변경한 File들을 Download할 수 있습니다. 포함된 File은 각각 다음과 같습니다.

• Build script : configure_my.sh
• FD refresh script : fd_ls.sh
• Error 수정한 hunspell.cxx : hunspell.cxx
• Error 수정한 chinese_direction.hrc : chinese_direction.hrc
• Error 수정한 AutoControls.hrc : AutoControls.hrc

– God Bless..

이 문서는 OpenOffice 2.0.2 source를 가지고 Win32 binary를 build하는 방법을 다룬다. build를 위한 전체과정을 요약하면 다음과 같다.

1. compiler, SDK, library 등을 받고 설치한다.
2. 소스를 받아 압축을 풀고 설정한 후 build를 시작한다.
3. build가 완료되면 packaging 되어 있는 EXE를 실행하여 OpenOffice.org를 설치한다.

OpenOffice.org를 build하는 것은 어려워 보이지만 실제로 해 보면 그다지 어려운 것은 없다. 다만 Windows를 Linux환경으로 emulating해서 build 하기 때문에 Linux에 관련한 전반적인 지식을 습득하면 유용할 것이다. 자 그럼, 이제 시작해보자…

2. Build Requirements

2.1. Hardware Requirements

원문에서는 다음과 같은 사양을 최소사양으로 한다.

• Intel Pentium II PC
• 128MB RAM (more recommended)
• 4GB free disk space (8GB for crashdump)

그러나 이런 사양에서 빌드한다면 아마 한달은 걸릴 것이다. 이것은 어디까지나 최소사양일 뿐이고 권장사양을 적어보겠다.

• Intel Pentium IV 2.4Ghz 이상
  (HyperThreading이 가능한 CPU는 HyperThreading을 끄고 build하는 것이 좋다. HyperThreading이 활성화 된 상황에서 build를 할 경우 문제가 발생하는 것으로 알려져 있다. – 자세한 내용 )
• 1GB RAM (多多益善 – 많으면 많을 수록 좋다.)
• 10GB 이상의 여유공간
  (Build 후 사용된 공간은 약 8GB 정도 된다. 여기에 각 module을 debugging하기 위해서 Debug Mode로 compile을 한다면 용량은 더 커질 것이다.)

2.2. Software Requirements

- Operating System

Windows XP Professional SP2 추천. 98, me는 build가 불가능하다. 그 이상은 다 가능하겠지만, XP Pro SP2가 가장 안정적일 것 같다.

- Compiler

Visual Studio .NET 2003 Professional 이상

M$에서 무료로 download 받을 수 있는 Visual C++ Toolkit 2003(=Visual C++ 2005 Express Edition)으로는 compile이 불가능하다.

- Library

1) Platform SDK (Download)

M$에서 제공하는 library를 사용할 수 있게 해주는 Development Kit.

OS 정품 사용자인지 확인을 하고 정품 사용자일 경우에만 download가 가능하다. SDK download와 정품 인증과는 무슨 상관관계가 있는지…

Platform SDK에서 다음 항목을 반드시 설치해야 한다.

• Microsoft Windows Core SDK (64bit 환경과 툴은 필요하지 않다.)
• Microsoft Web Workshop (IE) SDK
• Microsoft Internet Information Server (IIS) SDK
• Microsoft Data Access Services (MDAC) SDK
• Microsoft DirectShow SDK

Important note : Platform SDK 2005 april version을 사용하면 다음과 같은 문제가 있기 때문에 $PSDK_HOME/Lib/libcp.lib의 이름을 임시로 바꾼다.

2) DirectX 9.0 SDK (Download)

OpenOffice.org는 Win32 환경에서 DirectX를 Wrapping한 XCanvas를 통해 화면에 그리기를 수행한다. DirectX를 사용하도록 컴파일 하기 위해서 DirectX SDK를 설치한다.

Important note : 설치시 설치 폴더 이름을 짧게 하고 space가 들어있지 않게 한다. Space가 들어있을 경우 나중에 build 환경을 구성할 때 문제를 발생시킨다. (나의 경우 c:\DirectXSDK 에 설치했다.)

3) Java 2 SDK (Download)

Java 2 SDK 1.4.2가 필요하다. Java 5,6는 아직 사용이 불가능 하다.

- Build Tools

1) Ant (Download)

Ant는 Java의 Make utility이다.

설치방법 :
- 받은 Binary 압축 file을 C:\에 푼다. (ex) C:\ant
- 제어판 -> 시스템 -> 고급 -> 환경 변수 에 사용자 변수로 다음을 추가한다.

2) Cygwin (Download)

Cygwin은 Windows에서 Linux와 유사한 환경을 구현해 주는 것이다. 사용할 version은 1.5.10이상이어야 하며, 1.5.18은 피하기 바란다.(빌드 과정 중에 cabextract.exe 실행 되는 경우 빌드가 멈춤 상태가 되는 문제가 있다.)

Cygwin 설치 문서는 여기를 참고하고, 유의할 점은 설치시에 Default Text File Type은 Unix로 설정해야 한다. 물론 기본으로 선택 되어있다.

Cygwin의 모든 패키지를 설치할 필요는 없고 기본적으로 설치되는 패키지 외에 아래의 패키지만 설치하면 된다.

bision, flex, make, patch, perl, gcc, rxvt, tcsh, unzip, zip, cabextract (설치하면 유용한 패키지 : util-linux, vim)

Important note : Cygwin shell 안에서는 Symbolic link가 허락되지만, Windows에서는 Symbolic link의 개념이 없으므로 컴파일 시에 Visual C++ compiler가 인식하지 못한다. 그래서 Cygwin shell을 실행시킨 후, 아래와 같이 build에 사용되는 실행 파일의 Symbolic link를 지우고 link가 가리키고 있는 실제 파일을 복사해서 대체해 준다.

1 2 3 4

$ rm /usr/bin/awk.exe $ cp /usr/bin/gawk.exe /usr/bin/awk.exe $ rm /usr/bin/gunzip.exe $ cp /usr/bin/gzip.exe /usr/bin/gunzip.exe

3) Perl Module

OpenOffice.org를 build하기 위해서 Perl의 확장 module을 사용한다. 필요한 module은 Perl의 CPAN을 이용해서 컴파일해서 설치하게 된다. CPAN의 사용법은 여기를 참고하라.

빌드에 필요한 모듈 :
- XML::Parser : XML로 된 Build List를 위해 XML Parser Module을 사용한다. 기본으로 설치되어 있다.
- Archive::Zip : Image list를 압축하기 위해 사용한다. CPAN을 이용하여 설치할 것.

설치 방법 :

기본적인 CPAN의 설정을 위한 질문이 나온다. 디폴트로 값이 정해지도록 enter key로 질문을 넘긴다. 질문 중간에 download 받을 mirror의 주소를 질문하는데 그 중에서 Asia -> South Korea -> Freebsd server를 선택하도록 한다.

- Miscellaneous

1) Windows의 Temp directory 변경

Build 과정 중 MSI installer로 OpenOffice.org package를 만들 때 error가 나는 경우를 대비하기 위해서 Temp directory를 변경한다.
C:\temp를 만들고, 제어판 -> 시스템 -> 고급 -> 환경 변수 에 사용자 변수로 다음을 추가한다.

3. More..

이제 build를 할 수 있는 환경이 갖추어 졌다. Source를 가지고 compile및 설치하는 내용은 Part2에서 다룰 것이다.

– God Bless..