icu4j-readme.txt (3441B)
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. *Linux* 21 Download, configure, and build ICU4C. When you configure ICU4C, you must 22 set the environment variable ICU_DATA_BUILDTOOL_OPTS to 23 "--include_uni_core_data" to build additional required ICU4J data: 24 25 ICU_DATA_BUILDTOOL_OPTS=--include_uni_core_data ./runConfigureICU Linux 26 27 *Windows* 28 - Add ICU_DATA_BUILDTOOL_OPTS as a system environment variable with value "--include_uni_core_data" 29 set ICU_DATA_BUILDTOOL_OPTS=--include_uni_core_data 30 - Build %icu4c_root%\source\allinone\allinone.sln in Visual Studio 31 You can also do it from command line (adjust Platform if needed): 32 msbuild %icu4c_root%\source\allinone\allinone.sln /p:Configuration=Release /p:Platform=x64 /p:SkipUWP=true 33 34 For more instructions on downloading and building ICU4C, 35 see the ICU4C readme at: 36 https://htmlpreview.github.io/?https://github.com/unicode-org/icu/blob/main/icu4c/readme.html#HowToBuild 37 (Windows: build as 'x64, Release' otherwise you will have to set 'CFG' differently below.) 38 39 *NOTE* You should do a full rebuild after any data changes. 40 41 1a. If you didn't download from GitHub, 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. 42 43 44 2. Step 2 depends on whether you are on a Windows or a Unix-type 45 platform. 46 47 *Windows* 48 49 2a. On Developer Command Prompt for VS do 50 cd %icu4c_root%\source\data 51 nmake -f makedata.mak ICUMAKE=%icu4c_root%\source\data\ CFG=x64\Release JAR="%jdk_bin%\jar" ICU4J_ROOT=%icu4j_root% icu4j-data-install 52 53 2b. Do 54 cd %icu4j_root% 55 .\extract-data-files.bat 56 57 Continue with step 3 below, in Java: 58 59 60 *Linux* 61 62 $icu4c_build is the ICU4C root build directory, 63 which is $icu4c_root/source in an in-source build. 64 (in other words, $icu4c_build is where you ran runConfigureICU or configure) 65 66 2c. On the command line, cd to $icu4c_build/data 67 68 2d. Do 69 make JAR=$jdk_bin/jar ICU4J_ROOT=$icu4j_root icu4j-data-install 70 71 (You can omit the JAR if it's just jar.) 72 73 2e. Do 74 cd $icu4j_root 75 ./extract-data-files.sh 76 77 78 Continue with step 3, in Java: 79 80 Step 2 on either platform will produce two files: icudata.jar and 81 icutzdata.jar in $icu4j_root/main/shared/data. 82 83 *Java* 84 85 3. After the ICU4C-side steps above, build the ICU4J artifacts and run 86 the tests locally to make sure they pass: 87 88 cd $icu4j_root 89 mvn verify