diff --git a/icu4c/icu4c.css b/icu4c/icu4c.css index b6f2400f801..b7631ff9d93 100644 --- a/icu4c/icu4c.css +++ b/icu4c/icu4c.css @@ -500,7 +500,9 @@ td.proto { font-size: smaller; } - +.no-left-margin { + margin-left: 0; +} @media print { div#toc { diff --git a/icu4c/readme.html b/icu4c/readme.html index c42a08e73ed..3aaba825ede 100644 --- a/icu4c/readme.html +++ b/icu4c/readme.html @@ -787,25 +787,47 @@

The steps are:

    -
  1. Unzip the icu-XXXX.zip file into any convenient location. Using command - line zip, type "unzip -a icu-XXXX.zip -d drive:\directory", or just use - WinZip.
    2. +
  2. Unzip the icu-XXXX.zip file into any convenient location.
    + +
    3. -
  3. Be sure that the ICU binary directory, <ICU>\bin\, is +
  4. Be sure that the ICU binary directory, (ex: <ICU>\bin\), is included in the PATH environment variable. The tests will - not work without the location of the ICU DLL files in the path.
    5. + not work without the location of the ICU DLL files in the path. + Note that the binary directory name can depend on what architecture you select when you compile ICU. + For x86 or 32-bit builds, the binary directory is "bin". Whereas for x64 or 64-bit builds + the binary directory is "bin64". + -
  5. Open the "<ICU>\source\allinone\allinone.sln" workspace +
  6. Open the "<ICU>\source\allinone\allinone.sln" solution file in Microsoft Visual Studio. (This solution includes all the International Components for Unicode libraries, necessary ICU building - tools, and the test suite projects). Please see the command line note below if you want to + tools, and the test suite projects). Please see the + command line note below if you want to build from the command line instead.
    7. -
  7. You may need to re-target the UWP projects to the version of the SDK that you have installed. In Visual Studio you can - right-click on the UWP projects and select the option 'Retarget SDK Version'. Note: You do not need to have a copy of - the Windows 10 SDK installed in order to build the non-UWP projects in Visual Studio. If the SDK is not installed then the - UWP projects will simply not be loaded.
    8. +
  8. You may need to "re-target" the 3 UWP projects (common_uwp, i18n_uwp, and makedata_uwp) to + the version of the SDK that you have installed. In Visual Studio you can right-click on the + UWP projects in the Solution Explorer and select the option 'Retarget Projects' from the context menu. + This will open up a window where you can select the SDK version to target from a list of the + various SDKs that are installed on the machine. +
    Alternatively, you can manually edit the "*.vcxproj" files for the 3 UWP + projects to change the value of the "WindowsTargetPlatformVersion" property to the + version of the SDK that you would like to use instead.
    9. +
  9. Set the active platform to "Win32" or "x64" (See Windows platform note below) and configuration to "Debug" or "Release" (See Windows configuration note below).
    10. @@ -814,62 +836,81 @@ build the Debug and Release at the same time, see the batch configuration note below. -
  10. Run the tests. They can be run from the command line or from within Visual Studio. -

    Running the Tests from the Windows Command Line (cmd)

    - +

    Running the Tests from within Visual Studio

    -

    Running the Tests from within Visual Studio

    +
      +
    1. Run the C++ test suite, "intltest". To do this: set the active startup + project to "intltest", and press Ctrl+F5 to run it. Make sure that it + passes without any errors.
      2. -
        -
      1. Run the C++ test suite, "intltest". To do this: set the active startup - project to "intltest", and press Ctrl+F5 to run it. Make sure that it - passes without any errors.
        2. - -
      2. Run the C test suite, "cintltst". To do this: set the active startup - project to "cintltst", and press Ctrl+F5 to run it. Make sure that it - passes without any errors.
        3. - -
      3. Run the I/O test suite, "iotest". To do this: set the active startup - project to "iotest", and press Ctrl+F5 to run it. Make sure that it passes - without any errors.
        4. - -
      +
    2. Run the C test suite, "cintltst". To do this: set the active startup + project to "cintltst", and press Ctrl+F5 to run it. Make sure that it + passes without any errors.
      3. +
    3. Run the I/O test suite, "iotest". To do this: set the active startup + project to "iotest", and press Ctrl+F5 to run it. Make sure that it passes + without any errors.
      4. +
  11. You are now able to develop applications with ICU by using the - libraries and tools in <ICU>\bin\. The headers are in - <ICU>\include\ and the link libraries are in - <ICU>\lib\. To install the ICU runtime on a machine, or ship + libraries and tools in <ICU>\bin\. The headers are in + <ICU>\include\ and the link libraries are in + <ICU>\lib\. To install the ICU runtime on a machine, or ship it with your application, copy the needed components from - <ICU>\bin\ to a location on the system PATH or to your + <ICU>\bin\ to a location on the system PATH or to your application directory.

Using MSDEV At The Command Line - Note: You can build ICU from the command line. Assuming that you - have properly installed Microsoft Visual C++ to support command line - execution, you can run the following command to build the 32-bit Release version: - 'devenv.com <ICU>\source\allinone\allinone.sln /build "Release|Win32"'. - Or to build the 64-bit Release version from the command line: - 'devenv.com <ICU>\source\allinone\allinone.sln /build "Release|x64"'. -
You can also use Cygwin with this compiler to build ICU, and you can refer to the Using MSBUILD At The Command Line Note: + You can build ICU from the command line instead of using the Visual Studio GUI. + + Assuming that you have properly installed Visual Studio to support command line building, you + should have a shortcut for the "Developer Command Prompt" listed in the Start Menu. + (For Visual Studio 2017 you will need to install the "Desktop development with C++" option).

+ + + +

You can also use Cygwin with the MSVC compiler to build ICU, and you can refer to the How To Build And Install On Windows with Cygwin section for more details.

@@ -907,6 +948,16 @@ Build...". Click the "Select All" button, and then click the "Rebuild" button.

+

+ Building with other versions of MSVC Note: The particular version of the MSVC compiler + that is used to compile ICU is determined by the "PlatformToolset" property in the various + .vcxproj project files.
For example, <PlatformToolset>v140</PlatformToolset> + corresponds to the Visual Studio 2015 compiler tool set, whereas <PlatformToolset>v141</PlatformToolset> + corresponds to the Visual Studio 2017 compiler tool set. + However, using older versions of the MSVC compiler is generally not recommended due to the improved support for the C++11 standard + in newer versions of the compiler. Older versions of the compiler have reduced support for various C++11 features, many of which + are used by ICU.

+

How To Build And Install On Windows with Cygwin

@@ -916,7 +967,7 @@