projects / apple / icu.git / blame
| Commit | Line | Data |
|---|---|---|
| f3c0d7a5 A |
1 | Copyright (C) 2016 and later: Unicode, Inc. and others. |
| 2 | License & terms of use: http://www.unicode.org/copyright.html#License | |
| 3 | ||
| 73c04bcf | 4 | Copyright (c) 2002-2005, International Business Machines Corporation and others. All Rights Reserved. |
| b75a7d8f A |
5 | ufortune: a sample program demonstrating the use of ICU resource files by an application. |
| 6 | ||
| 7 | This sample demonstrates | |
| 8 | Defining resources for use by an application | |
| 9 | Compiling and packaging them into a dll | |
| 10 | Referencing the resource-containing dll from application code | |
| 11 | Loading resource data using ICU's API | |
| 12 | ||
| 13 | Files: | |
| 14 | ./ufortune.c source code for the sample | |
| 73c04bcf A |
15 | ./ufortune.sln Windows MSVC workspace. Double-click this to get started. |
| 16 | ./ufortune.vcproj Windows MSVC project file. | |
| b75a7d8f A |
17 | ./Makefile Makefile for Unixes. Needs gmake. |
| 18 | resources/root.txt Default resources (text for messages in English) | |
| 19 | resources/es.txt Spanish language resources source file.. | |
| 20 | resources/res-file-list.txt List of resource source files to be built | |
| 21 | resources/Makefile Makefile for compiling resources, for Unixes. | |
| 22 | ||
| 23 | ||
| 24 | To Build ufortune on Windows | |
| 25 | 1. Install and build ICU | |
| 73c04bcf | 26 | 2. In MSVC, open the workspace file icu\samples\ufortune\ufortune.sln |
| b75a7d8f A |
27 | 3. Choose a Debug or Release build. |
| 28 | 4. Build. | |
| 29 | ||
| 30 | To Run on Windows | |
| 31 | 1. Start a command shell window | |
| 32 | 2. Add ICU's bin directory to the path, e.g. | |
| 33 | set PATH=c:\icu\bin;%PATH% | |
| 34 | (Use the path to where ever ICU is on your system.) | |
| 35 | 3. cd into the ufortune directory, e.g. | |
| 36 | cd c:\icu\source\samples\ufortune\debug | |
| 37 | 4. Run it | |
| 38 | ufortune | |
| 39 | ||
| 40 | ||
| 41 | To Build on Unixes | |
| 42 | 1. Build ICU. Specify an ICU install directory when running configure, | |
| 43 | using the --prefix option. The steps to build ICU will look something | |
| 44 | like this: | |
| 45 | cd <icu directory>/source | |
| 46 | runConfigureICU <platform-name> --prefix <icu install directory> [other options] | |
| 47 | gmake all | |
| 48 | ||
| 49 | 2. Install ICU, | |
| 50 | gmake install | |
| 51 | ||
| 52 | 3. Build the sample | |
| 53 | cd <icu directory>/source/samples/ufortune | |
| 54 | export ICU_PREFIX= <icu install directory> | |
| 55 | gmake | |
| 56 | ||
| 57 | To Run on Unixes | |
| 58 | cd <icu directory>/source/samples/ufortune | |
| 59 | ||
| 60 | gmake check | |
| 61 | or | |
| 62 | export LD_LIBRARY_PATH=<icu install directory>/lib:.:$LD_LIBRARY_PATH | |
| 63 | ufortune | |
| 64 | ||
| 65 | ||
| 66 | Note: The name of the LD_LIBRARY_PATH variable is different on some systems. | |
| 67 | If in doubt, run the sample using "gmake check", and note the name of | |
| 68 | the variable that is used there. LD_LIBRARY_PATH is the correct name | |
| 69 | for Linux and Solaris. |