Imported Upstream version 58.1
[platform/upstream/icu.git] / source / data / icu4j-readme.txt
1 * Copyright (C) 2016 and later: Unicode, Inc. and others.
2 * License & terms of use: http://www.unicode.org/copyright.html
3 ********************************************************************************
4 * Copyright (C) 2008-2012, International Business Machines Corporation         *
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:
22         http://source.icu-project.org/repos/icu/icu/trunk/readme.html#HowToBuild
23         (Windows: build as x86, Release otherwise you will have to set 'CFG' differently below.)
24
25         *NOTE* You should do a full rebuild after any data changes.
26 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.  
27
28
29 2. Step 2 depends on whether you are on a Windows or a Unix-type
30 platform.
31
32 *Windows* 
33
34 2a. On the command line, cd to $icu4c_root\source\data.
35
36 2b. On the command line,
37         nmake -f makedata.mak ICUMAKE=$icu4c_root\source\data\  CFG=x86\Release JAR="$jdk_bin\jar" ICU4J_ROOT=$icu4j_root  icu4j-data-install
38
39        Continue with step 3 below, in Java:
40
41
42 *Linux*
43
44         $icu4c_build is the ICU4C root build directory,
45         which is $icu4c_root/source in an in-source build.
46         (in other words, $icu4c_build is where you ran runConfigureICU or configure)
47
48 2c. On the command line, cd to $icu4c_build/data
49
50 2d. Do
51         make JAR=$jdk_bin/jar ICU4J_ROOT=$icu4j_root icu4j-data-install
52
53        (You can omit the JAR if it's just jar.)
54
55         Continue with step 3, in Java:
56
57 Step 2 on either platform will produce two files: icudata.jar and
58 icutzdata.jar in $icu4j_root/main/shared/data.
59
60 *Java*
61
62 3. After the ICU4C-side steps above, build the main target of the
63         ICU4J ant build to unpack the jar files with the following commands:
64
65         cd $icu4j_root
66         ant main