version 76.1.1

Author: apotocki

.github/workflows/main.yml

@@ -16,7 +16,7 @@ jobs:
         submodules: 'true'
     - name: Build
       run: |
-        scripts/build.sh
+        scripts/build.sh -p=macosx-both,ios,iossim-both,catalyst-both,xros,xrossim-both,watchos,watchossim-both,tvos,tvossim-both
         for i in product/frameworks/*.xcframework/; do cd product/frameworks && zip -9 -r -r "$(basename -- $i).zip" $(basename -- $i) & done; wait
         cd product
         zip -9 -r include.zip include

.gitmodules

@@ -1,16 +1,15 @@
-## ICU for iOS, visionOS, macOS (Intel & Apple Silicon M1) & Catalyst - arm64 / x86_64
+## ICU for iOS, watchOS, tvOS, visionOS, macOS, Catalyst, Simulators - Intel(x86_64) / Apple Silicon(arm64)
 
 Supported versions: 76.1
 
-This repo provides a universal script for building static ICU libraries for use in iOS, visionOS, and macOS applications. The actual ICU library version is taken from https://github.com/unicode-org/icu . The repo branches correspond to the suitable branches of ICU repo. E.g. "76" branch corresponds to "maint/maint-76" branch.
+This repo provides a universal script for building static ICU libraries for use in iOS, watchOS, tvOS, visionOS, and macOS applications. The actual ICU library version is taken from https://github.com/unicode-org/icu . The branches of the repository generally correspond to the branches of the ICU repository. E.g. "76" branch corresponds to "maint/maint-76" branch.
 
-## Prerequisites
-  1) Xcode must be installed because xcodebuild is used to create xcframeworks
-  2) ```xcode-select -p``` must point to Xcode app developer directory (by default e.g. /Applications/Xcode.app/Contents/Developer). If it points to CommandLineTools directory you should execute:
+# Prerequisites
+  1) Xcode must be installed as xcodebuild is used to create xcframeworks
+  2) ```xcode-select -p``` must point to the Xcode app developer directory (by default e.g. /Applications/Xcode.app/Contents/Developer). If it points to the CommandLineTools directory you should run:
   ```sudo xcode-select --reset``` or ```sudo xcode-select -s /Applications/Xcode.app/Contents/Developer```
 
-## How to build?
- - Manually
+# Build Manually
 ```
     # clone the repo
     git clone -b 76 https://github.com/apotocki/icu4c-iosx
@@ -20,13 +19,63 @@ This repo provides a universal script for building static ICU libraries for use
     scripts/build.sh
 
     # have fun, the result artifacts  will be located in 'product' folder.
-```    
- - Use cocoapods. Add the following lines into your project's Podfile:
+```
+# Selecting Platforms and Architectures
+build.sh without arguments will build xcframeworks for iOS, macOS, and also for watchOS, tvOS, visionOS if their SDKs are installed on the system. It will also build xcframeworks for their simulators with the architecture (arm64 or x86_64) depending on the current host.
+If you are interested in a specific set of platforms and architectures, you can specify them explicitly using the -p argument, for example:
+```
+scripts/build.sh -p=ios,iossim-x86_64
+# builts xcframeworks only for iOS and iOS Simulator with x86_64 architecture
+```
+Here is a list of all possible values for '-p' option:
+```
+macosx,macosx-arm64,macosx-x86_64,macosx-both,ios,iossim,iossim-arm64,iossim-x86_64,iossim-both,catalyst,catalyst-arm64,catalyst-x86_64,catalyst-both,xros,xrossim,xrossim-arm64,xrossim-x86_64,xrossim-both,tvos,tvossim,tvossim-both,tvossim-arm64,tvossim-x86_64,watchos,watchossim,watchossim-both,watchossim-arm64,watchossim-x86_64
+```
+Suffix '-both' means that xcframeworks will be built for both arm64 and x86_64 architectures.
+
+# ICU Data Archive
+The build.sh script builds the following xcframeworks: icudata, icui18n, icuio, and icuuc.
+By default, 'icudata' is built with the --with-data-packaging=static option (see https://unicode-org.github.io/icu/userguide/icu_data/). So all the metadata (locales, tables, etc) is placed into icudata library making it quite large (~32MB). Since xcframework may contain libraries for multiple platforms and architectures this metadata is duplicated multiple times wasting space. Therefore, ICU allows to move the metadata to a separate platform-independent file that must be loaded during the library initialization. To activate this option you can specify -d=archive :
+```
+scripts/build.sh -p=ios,iossim-x86_64 -d=archive
+# builts xcframeworks for iOS and iOS Simulator with x86_64 architecture
+# datafile path is product/share/icu/76.1/icudt76l.dat
+```
+In that case, during the ICU initialization procedure you have to specify ICU data directory before u_init() call:
+
+```
+#include <unicode/putil.h>
+
+... // somewhere in ICU initialization procedure before u_init call
+u_setDataDirectory("PATH TO THE DIRECTORY WHERE icudt76l.dat is located");
+
+u_init(code)
+...
+```
+
+## ICU Data Filtering
+ICU metadata is a rather large set of different locales, tables, rules and so on. It's very likely that you won't need all of them in your application. Fortunately, we can filter the data we need when building the icudata library by specifying the filter with the -f option:
+```
+scripts/build.sh -p=ios,iossim-x86_64 -f=path_to_filter.json
+# builts xcframeworks for iOS and iOS Simulator with x86_64 architecture
+```
+The format of the filter is described at https://unicode-org.github.io/icu/userguide/icu_data/buildtool.html
+
+## Rebuild option
+To rebuild the library without using the results of previous builds, use the --rebuild option
+```
+scripts/build.sh -p=ios,iossim-x86_64 --rebuild
+
+```
+
+# Build Using Cocoapods.
+Add the following lines into your project's Podfile:
 ```
     use_frameworks!
     pod 'icu4c-iosx', '~> 76.1'
+    
     # or optionally more precisely
-    # pod 'icu4c-iosx', :git => 'https://github.com/apotocki/icu4c-iosx', :tag => '76.1.0'
+    # pod 'icu4c-iosx', :git => 'https://github.com/apotocki/icu4c-iosx', :tag => '76.1.1'
 ```    
 install new dependency:
 ```

README.md

@@ -6,11 +6,11 @@ install! 'cocoapods', :deterministic_uuids => false
 target 'icu4c-demo (iOS)' do
   use_frameworks!
   pod 'icu4c-iosx'
-  #pod 'icu4c-iosx', :git => 'https://github.com/apotocki/icu4c-iosx', :branch => '73', :submodules => 'true'
+  #pod 'icu4c-iosx', :git => 'https://github.com/apotocki/icu4c-iosx', :branch => '76'
 end
 
 target 'icu4c-demo (macOS)' do
   use_frameworks!
   pod 'icu4c-iosx'
-  #pod 'icu4c-iosx', :git => 'https://github.com/apotocki/icu4c-iosx', :branch => '73', :submodules => 'true'
+  #pod 'icu4c-iosx', :git => 'https://github.com/apotocki/icu4c-iosx', :branch => '76'
 end

demo/Podfile

@@ -1,22 +1,22 @@
 Pod::Spec.new do |s|
     s.name         = "icu4c-iosx"
-    s.version      = "76.1.0"
-    s.summary      = "ICU XCFramework for macOS, iOS, and visionOS, including both arm64 and x86_64 builds for macOS, Mac Catalyst, iOS Simulator, and visionOS Simulator."
+    s.version      = "76.1.1"
+    s.summary      = "ICU XCFramework for macOS, iOS, watchOS, tvOS, and visionOS, including builds for Mac Catalyst, iOS Simulator, watchOS Simulator, tvOS Simulator, and visionOS Simulator."
     s.homepage     = "https://github.com/apotocki/icu4c-iosx"
     s.license      = "BSD"
     s.author       = { "Alexander Pototskiy" => "[email protected]" }
     s.social_media_url = "https://www.linkedin.com/in/alexander-pototskiy"
+    s.pod_target_xcconfig = { 'ONLY_ACTIVE_ARCH' => 'YES' }
     s.ios.deployment_target = "13.4"
     s.osx.deployment_target = "11.0"
+    s.tvos.deployment_target = "13.0"
+    s.watchos.deployment_target = "11.0"
     s.visionos.deployment_target = "1.0"
-    s.osx.pod_target_xcconfig = { 'ONLY_ACTIVE_ARCH' => 'YES' }
-    s.ios.pod_target_xcconfig = { 'ONLY_ACTIVE_ARCH' => 'YES' }
-    s.visionos.pod_target_xcconfig = { 'ONLY_ACTIVE_ARCH' => 'YES' }
     s.static_framework = true
-    s.prepare_command = "sh scripts/build.sh"
-    s.source       = { :git => "https://github.com/apotocki/icu4c-iosx.git", :tag => "#{s.version}", :submodules => "true" }
+    s.source       = { :git => "https://github.com/apotocki/icu4c-iosx.git", :tag => "#{s.version}" }
     s.source_files = "product/include/**/*.{h}"
     s.header_mappings_dir = "product/include"
+    s.prepare_command = "sh scripts/build.sh"
     s.public_header_files = "product/include/**/*.{h}"
     s.vendored_frameworks = "product/frameworks/icudata.xcframework", "product/frameworks/icui18n.xcframework", "product/frameworks/icuio.xcframework", "product/frameworks/icuuc.xcframework"
 end