[apple/icu.git] / icuSources / data / icu4j-readme.txt

********************************************************************************
* Copyright (C) 2008-2012, International Business Machines Corporation         *
* and others. All Rights Reserved.                                             *
*                                                                              *
* 6/26/08 - Created by Brian Rower - heavy copying from ICU4J readme & others  *
*                                                                              *
********************************************************************************

Procedures for building ICU4J data from ICU4C data:

*Setup*

In the following,
        $icu4c_root is the ICU4C root directory
        $icu4j_root is the ICU4J root directory
        $jdk_bin is the JDK bin directory (for the jar tool)

1. Download and build ICU4C. For more instructions on downloading and building
        ICU4C, see the ICU4C readme at:
        http://source.icu-project.org/repos/icu/icu/trunk/readme.html#HowToBuild
	(Windows: build as x86, Release otherwise you will have to set 'CFG' differently below.)

	*NOTE* You should do a full rebuild after any data changes.
1a.  If you didn't download from Subversion, you will also need the "icu4c-*-data.zip" file.  Unpack this file and replace the icu/source/data directory's contents with the contents of the data directory from the zip file.  


2. Step 2 depends on whether you are on a Windows or a Unix-type
platform.

*Windows* 

2a. On the command line, cd to $icu4c_root\source\data.

2b. On the command line,
        nmake -f makedata.mak ICUMAKE=$icu4c_root\source\data\  CFG=x86\Release JAR="$jdk_bin\jar" ICU4J_ROOT=$icu4j_root  icu4j-data-install

       Continue with step 3 below, in Java:


*Linux*

        $icu4c_build is the ICU4C root build directory,
        which is $icu4c_root/source in an in-source build.
        (in other words, $icu4c_build is where you ran runConfigureICU or configure)

2c. On the command line, cd to $icu4c_build/data

2d. Do
        make JAR=$jdk_bin/jar ICU4J_ROOT=$icu4j_root icu4j-data-install

       (You can omit the JAR if it's just jar.)

	Continue with step 3, in Java:

Step 2 on either platform will produce two files: icudata.jar and
icutzdata.jar in $icu4j_root/main/shared/data.

*Java*

3. After the ICU4C-side steps above, build the main target of the
        ICU4J ant build to unpack the jar files with the following commands:

        cd $icu4j_root
        ant main
Commit	Line	Data
729e4ab9	1	********************************************************************************
4388f060	2	* Copyright (C) 2008-2012, International Business Machines Corporation *
729e4ab9 A	3	* and others. All Rights Reserved. *
	4	* *
	5	* 6/26/08 - Created by Brian Rower - heavy copying from ICU4J readme & others *
	6	* *
	7	********************************************************************************
	8
	9	Procedures for building ICU4J data from ICU4C data:
	10
	11	Setup
	12
	13	In the following,
	14	$icu4c_root is the ICU4C root directory
	15	$icu4j_root is the ICU4J root directory
	16	$jdk_bin is the JDK bin directory (for the jar tool)
	17
	18	1. Download and build ICU4C. For more instructions on downloading and building
	19	ICU4C, see the ICU4C readme at:
	20	http://source.icu-project.org/repos/icu/icu/trunk/readme.html#HowToBuild
	21	(Windows: build as x86, Release otherwise you will have to set 'CFG' differently below.)
	22
	23	NOTE You should do a full rebuild after any data changes.
51004dcb	24	1a. If you didn't download from Subversion, you will also need the "icu4c-*-data.zip" file. Unpack this file and replace the icu/source/data directory's contents with the contents of the data directory from the zip file.
729e4ab9 A	25
	26
	27	2. Step 2 depends on whether you are on a Windows or a Unix-type
	28	platform.
	29
	30	Windows
	31
	32	2a. On the command line, cd to $icu4c_root\source\data.
	33
	34	2b. On the command line,
	35	nmake -f makedata.mak ICUMAKE=$icu4c_root\source\data\ CFG=x86\Release JAR="$jdk_bin\jar" ICU4J_ROOT=$icu4j_root icu4j-data-install
	36
	37	Continue with step 3 below, in Java:
	38
	39
	40	Linux
	41
	42	$icu4c_build is the ICU4C root build directory,
51004dcb A	43	which is $icu4c_root/source in an in-source build.
51004dcb A	44	(in other words, $icu4c_build is where you ran runConfigureICU or configure)
729e4ab9	45
51004dcb	46	2c. On the command line, cd to $icu4c_build/data
729e4ab9 A	47
	48	2d. Do
	49	make JAR=$jdk_bin/jar ICU4J_ROOT=$icu4j_root icu4j-data-install
	50
	51	(You can omit the JAR if it's just jar.)
	52
	53	Continue with step 3, in Java:
	54
4388f060 A	55	Step 2 on either platform will produce two files: icudata.jar and
	56	icutzdata.jar in $icu4j_root/main/shared/data.
	57
729e4ab9 A	58	Java
729e4ab9 A	59
4388f060 A	60	3. After the ICU4C-side steps above, build the main target of the
4388f060 A	61	ICU4J ant build to unpack the jar files with the following commands:
729e4ab9 A	62
729e4ab9 A	63	cd $icu4j_root
4388f060	64	ant main