From 0fe07077952b85bcdda45aecddfdf37b885ef7d9 Mon Sep 17 00:00:00 2001 From: Max Topolsky Date: Thu, 6 Nov 2025 11:31:48 -0500 Subject: [PATCH 1/3] update instructions for string minification --- docs/platforms/apple/guides/ios/size-analysis/insights.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/platforms/apple/guides/ios/size-analysis/insights.mdx b/docs/platforms/apple/guides/ios/size-analysis/insights.mdx index 96f3192b85e0a..8e8c494dee66b 100644 --- a/docs/platforms/apple/guides/ios/size-analysis/insights.mdx +++ b/docs/platforms/apple/guides/ios/size-analysis/insights.mdx @@ -234,11 +234,11 @@ Update the Info.plist alternate icon entry to point at the new `.heic` file. #### Option 1: Keep the format lean -- Encode localized strings as plain text (`"key" = "value";`), not binary plists. Set **Strings File Output Encoding** (`STRINGS_FILE_OUTPUT_ENCODING`) to **UTF-8** in Xcode. +- Use the newer [String Catalog](https://developer.apple.com/documentation/xcode/localizing-and-varying-text-with-a-string-catalog) to store strings in a more efficient format. #### Option 2: Strip comments automatically -String files can have comments that ship with the bundle. They help during translation but take space in production. A typical comment may look like: +If you're strings are encoded as text, these files can have extra comments and whitespace that ship with the bundle. They help during translation but take space in production. A typical comment may look like: ```text /* Title for the expired code alert. */ From 772350750be33ec70ced9c1fc87b626565b2cbfe Mon Sep 17 00:00:00 2001 From: Max Topolsky Date: Thu, 6 Nov 2025 11:33:13 -0500 Subject: [PATCH 2/3] whoops grammar --- docs/platforms/apple/guides/ios/size-analysis/insights.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/platforms/apple/guides/ios/size-analysis/insights.mdx b/docs/platforms/apple/guides/ios/size-analysis/insights.mdx index 8e8c494dee66b..6081b76acb22d 100644 --- a/docs/platforms/apple/guides/ios/size-analysis/insights.mdx +++ b/docs/platforms/apple/guides/ios/size-analysis/insights.mdx @@ -238,7 +238,7 @@ Update the Info.plist alternate icon entry to point at the new `.heic` file. #### Option 2: Strip comments automatically -If you're strings are encoded as text, these files can have extra comments and whitespace that ship with the bundle. They help during translation but take space in production. A typical comment may look like: +If strings are encoded as text, these files can have extra comments and whitespace that ship with the bundle. They help during translation but take space in production. A typical comment may look like: ```text /* Title for the expired code alert. */ From dd976cea6a13e59de79caa6784d6a0424fab165f Mon Sep 17 00:00:00 2001 From: Max Topolsky Date: Thu, 6 Nov 2025 11:36:15 -0500 Subject: [PATCH 3/3] more --- docs/platforms/apple/guides/ios/size-analysis/insights.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/platforms/apple/guides/ios/size-analysis/insights.mdx b/docs/platforms/apple/guides/ios/size-analysis/insights.mdx index 6081b76acb22d..8f372a54f3a5e 100644 --- a/docs/platforms/apple/guides/ios/size-analysis/insights.mdx +++ b/docs/platforms/apple/guides/ios/size-analysis/insights.mdx @@ -234,7 +234,7 @@ Update the Info.plist alternate icon entry to point at the new `.heic` file. #### Option 1: Keep the format lean -- Use the newer [String Catalog](https://developer.apple.com/documentation/xcode/localizing-and-varying-text-with-a-string-catalog) to store strings in a more efficient format. +- Use the newer [String Catalog](https://developer.apple.com/documentation/xcode/localizing-and-varying-text-with-a-string-catalog) to store strings in a more efficient format. Ensure STRINGS_FILE_OUTPUT_ENCODING is set to bplist to get an efficient encoding that automatically strips whitespace and comments. #### Option 2: Strip comments automatically