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

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