Skip to content

Commit b9710d3

Browse files
1998code1998code
committed
Add localized READMEs; bump demo & tweak text layout
Prepare 2.2.0 release: add localized README files (JP, CN, TW, HK, KR) and add language links in main README; update main README version to 2.2.0. Bump Demo Xcode project CURRENT_PROJECT_VERSION to 3, MARKETING_VERSION to 2.2 and set TARGETED_DEVICE_FAMILY to 1; update workspace user interface state. Adjust SplashScreenKit text layout to avoid truncation/overflow by adding lineLimit and minimumScaleFactor on title, caption and product text elements for better scaling on small devices.
1 parent ee05d14 commit b9710d3

9 files changed

Lines changed: 502 additions & 9 deletions

File tree

‎Demo/Demo.xcodeproj/project.pbxproj‎

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -409,7 +409,7 @@
409409
ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon;
410410
ASSETCATALOG_COMPILER_GLOBAL_ACCENT_COLOR_NAME = AccentColor;
411411
CODE_SIGN_STYLE = Automatic;
412-
CURRENT_PROJECT_VERSION = 1;
412+
CURRENT_PROJECT_VERSION = 3;
413413
DEVELOPMENT_ASSET_PATHS = "\"Demo/Preview Content\"";
414414
DEVELOPMENT_TEAM = "";
415415
ENABLE_PREVIEWS = YES;
@@ -426,7 +426,7 @@
426426
"$(inherited)",
427427
"@executable_path/Frameworks",
428428
);
429-
MARKETING_VERSION = 1.1;
429+
MARKETING_VERSION = 2.2;
430430
PRODUCT_BUNDLE_IDENTIFIER = SplashScreen.Demo;
431431
PRODUCT_NAME = "$(TARGET_NAME)";
432432
SUPPORTED_PLATFORMS = "iphoneos iphonesimulator";
@@ -435,7 +435,7 @@
435435
SUPPORTS_XR_DESIGNED_FOR_IPHONE_IPAD = NO;
436436
SWIFT_EMIT_LOC_STRINGS = YES;
437437
SWIFT_VERSION = 5.0;
438-
TARGETED_DEVICE_FAMILY = "1,2";
438+
TARGETED_DEVICE_FAMILY = 1;
439439
};
440440
name = Debug;
441441
};
@@ -445,7 +445,7 @@
445445
ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon;
446446
ASSETCATALOG_COMPILER_GLOBAL_ACCENT_COLOR_NAME = AccentColor;
447447
CODE_SIGN_STYLE = Automatic;
448-
CURRENT_PROJECT_VERSION = 1;
448+
CURRENT_PROJECT_VERSION = 3;
449449
DEVELOPMENT_ASSET_PATHS = "\"Demo/Preview Content\"";
450450
DEVELOPMENT_TEAM = "";
451451
ENABLE_PREVIEWS = YES;
@@ -462,7 +462,7 @@
462462
"$(inherited)",
463463
"@executable_path/Frameworks",
464464
);
465-
MARKETING_VERSION = 1.1;
465+
MARKETING_VERSION = 2.2;
466466
PRODUCT_BUNDLE_IDENTIFIER = SplashScreen.Demo;
467467
PRODUCT_NAME = "$(TARGET_NAME)";
468468
SUPPORTED_PLATFORMS = "iphoneos iphonesimulator";
@@ -471,7 +471,7 @@
471471
SUPPORTS_XR_DESIGNED_FOR_IPHONE_IPAD = NO;
472472
SWIFT_EMIT_LOC_STRINGS = YES;
473473
SWIFT_VERSION = 5.0;
474-
TARGETED_DEVICE_FAMILY = "1,2";
474+
TARGETED_DEVICE_FAMILY = 1;
475475
};
476476
name = Release;
477477
};

‎Demo/Demo.xcodeproj/project.xcworkspace/xcuserdata/ming.xcuserdatad/UserInterfaceState.xcuserstate‎

1.12 KB
Binary file not shown.

‎README.md‎

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,12 @@
11
# SplashScreenKit
22
### A New Splash Screen for SwiftUI
33

4+
[日本語](./Readme/README_JP.md) | [繁體中文](./Readme/README_TW.md) | [简体中文](./Readme/README_CN.md) | [香港粵語](./Readme/README_HK.md) | [한국어](./Readme/README_KR.md)
5+
46
<img width="1585" alt="Screenshot 2025-02-10 at 8 18 53 PM" src="https://github.com/user-attachments/assets/7f35a079-f74d-4c35-8f25-ea3239cc645f" />
57

68
## Version
7-
**2.1.0 (Stable Release)** <br>
9+
**2.2.0 (Stable Release)** <br>
810
*Optimized for high-performance interaction with zero jank.*
911

1012
- **Seamless Infinite Carousel:** New virtual-index logic prevents "flying cards" and ensures smooth infinite rotation.

‎Readme/README_CN.md‎

Lines changed: 97 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,97 @@
1+
# SplashScreenKit
2+
### SwiftUI 全新启动页 (Splash Screen)
3+
4+
[English](../README.md) | [日本語](./README_JP.md) | [繁體中文](./README_TW.md) | [香港粵語](./README_HK.md) | [한국어](./README_KR.md)
5+
6+
<img width="1585" alt="Screenshot 2025-02-10 at 8 18 53 PM" src="https://github.com/user-attachments/assets/7f35a079-f74d-4c35-8f25-ea3239cc645f" />
7+
8+
## 版本
9+
**2.2.0 (稳定版本)** <br>
10+
*针对高性能交互进行了优化，确保零卡顿体验。*
11+
12+
- **无缝无限轮播：** 全新的虚拟索引逻辑，防止“卡片飞走”并确保流畅的无限旋转。
13+
- **性能优化：** 采用 Metal 加速渲染 (`drawingGroup`) 以及通过 `RunLoop` 进行高效的每帧更新。
14+
- **动量滚动：** 丝滑般流畅、基于速度的交互手势，具备原生减速感。
15+
- **AsyncImage 支持：** 经过预验证的 URL 处理，实现无延迟的远程图片加载。
16+
- **两种显示模式：** 可在动态的 `.carousel` 和优雅的 `.static` 布局之间选择。
17+
- **高级文字效果：** 利用 SwiftUI 6.0 功能实现美观的文字渲染和过渡效果。
18+
19+
## 环境 / 测试平台
20+
- 📲 需要 iOS 18.0+
21+
- Swift 6.0
22+
- Xcode 16.0+
23+
24+
## 如何使用
25+
將套件新增至您的專案： ```https://github.com/1998code/19-Splash-Screen-for-SwiftUI```
26+
27+
### 轮播模式 (默认)
28+
经典的图片旋转交互体验。
29+
```swift
30+
SplashScreen(
31+
images: [
32+
Photo("ImageName1"),
33+
Photo("https://example.com/image.jpg") // 支持远程 URL！
34+
],
35+
title: "Welcome to",
36+
product: "Apple TV",
37+
caption: "Browse all movies, TV shows, and more.",
38+
cta: "Watch Now"
39+
) {
40+
print("Action Button Tapped")
41+
}
42+
```
43+
44+
<img src="https://github.com/user-attachments/assets/28c8a5dc-cb8c-4aa4-b0a8-d7139ce3cefc" width="350" />
45+
46+
### 静态模式 (全新)
47+
简洁、可滚动的布局，非常适合产品介绍。
48+
```swift
49+
SplashScreen(
50+
mode: .static,
51+
images: [Photo("https://url.to/header_image.jpg")],
52+
title: "Creator Studio",
53+
product: "3 months of Creator Studio for free.",
54+
caption: "Bring your vision to life with powerful apps.",
55+
features: [
56+
SplashFeature(title: "Feature 1", icon: "video"),
57+
SplashFeature(title: "Feature 2", icon: "waveform")
58+
],
59+
footer: "Terms and conditions apply.",
60+
cta: "Accept Offer",
61+
secondaryCta: "See All Plans",
62+
secondaryAction: {
63+
print("Secondary action tapped")
64+
}
65+
) {
66+
print("Primary action tapped")
67+
}
68+
```
69+
70+
<img src="https://github.com/user-attachments/assets/44f9aeef-7906-4251-b338-f9504b30b278" width="350" />
71+
72+
## 已知问题
73+
- 仅支持 iOS 18+，利用了最新的 SwiftUI `TextRenderer` 和视觉效果 API。
74+
- 尺寸调整：轮播模式针对 Pro/Pro Max 进行了优化。静态模式包含 ScrollView 以处理较小的设备和不同的内容长度。
75+
76+
## 版权
77+
App Store 屏幕截图 © 2025 Apple Inc.
78+
79+
## 参考
80+
[Creating visual effects with SwiftUI - Apple Developer](https://developer.apple.com/documentation/swiftui/creating-visual-effects-with-swiftui)
81+
82+
## X 上的相关贴文
83+
https://x.com/1998design/status/1888641485303878110 <br>
84+
https://x.com/1998design/status/1888945523845140677
85+
86+
## 组合推荐
87+
配合 [SwiftNEWKit](https://github.com/1998code/SwiftNEWKit) 同时使用，效果翻倍！
88+
<br><br>
89+
<img height=300 src="https://github.com/user-attachments/assets/cc88b31d-326f-4a43-9e6a-5f583fcf153b" />
90+
91+
## 许可证
92+
MIT
93+
94+
## 赞助
95+
<a href="https://m.do.co/c/ce873177d9ab">
96+
<img src="https://opensource.nyc3.cdn.digitaloceanspaces.com/attribution/assets/SVG/DO_Logo_horizontal_blue.svg" width="201px">
97+
</a>

‎Readme/README_HK.md‎

Lines changed: 97 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,97 @@
1+
# SplashScreenKit
2+
### SwiftUI 全新啟動頁面 (Splash Screen)
3+
4+
[English](../README.md) | [日本語](./README_JP.md) | [繁體中文](./README_TW.md) | [简体中文](./README_CN.md) | [한국어](./README_KR.md)
5+
6+
<img width="1585" alt="Screenshot 2025-02-10 at 8 18 53 PM" src="https://github.com/user-attachments/assets/7f35a079-f74d-4c35-8f25-ea3239cc645f" />
7+
8+
## 版本
9+
**2.2.0 (穩定版本)** <br>
10+
*針對高性能互動優化，做到零卡頓。*
11+
12+
- **無縫無限輪播：** 全新虛擬索引邏輯，防止「卡片飛走」，確保無限旋轉順滑。
13+
- **性能優化：** 採用 Metal 加速渲染 (`drawingGroup`) 同埋透過 `RunLoop` 進行高效嘅每幀更新。
14+
- **動量捲動：** 絲滑般流暢、基於速度嘅互動手勢，有原生嘅減速感。
15+
- **AsyncImage 支援：** 經過預先驗證嘅 URL 處理，實現無延遲嘅遠端圖片載入。
16+
- **兩種顯示模式：** 可以喺動態嘅 `.carousel` 同優雅嘅 `.static` 佈局之間選擇。
17+
- **高級文字效果：** 利用 SwiftUI 6.0 功能實現靚嘅文字渲染同過渡效果。
18+
19+
## 環境 / 測試平台
20+
- 📲 需要 iOS 18.0+
21+
- Swift 6.0
22+
- Xcode 16.0+
23+
24+
## 點樣使用
25+
將套件加落你個 Project： ```https://github.com/1998code/19-Splash-Screen-for-SwiftUI```
26+
27+
### 輪播模式 (預設)
28+
經典嘅圖片旋轉互動體驗。
29+
```swift
30+
SplashScreen(
31+
images: [
32+
Photo("ImageName1"),
33+
Photo("https://example.com/image.jpg") // 支援遠端 URL！
34+
],
35+
title: "Welcome to",
36+
product: "Apple TV",
37+
caption: "Browse all movies, TV shows, and more.",
38+
cta: "Watch Now"
39+
) {
40+
print("Action Button Tapped")
41+
}
42+
```
43+
44+
<img src="https://github.com/user-attachments/assets/28c8a5dc-cb8c-4aa4-b0a8-d7139ce3cefc" width="350" />
45+
46+
### 靜態模式 (全新)
47+
簡潔、可捲動嘅佈局，好啱做產品介紹。
48+
```swift
49+
SplashScreen(
50+
mode: .static,
51+
images: [Photo("https://url.to/header_image.jpg")],
52+
title: "Creator Studio",
53+
product: "3 months of Creator Studio for free.",
54+
caption: "Bring your vision to life with powerful apps.",
55+
features: [
56+
SplashFeature(title: "Feature 1", icon: "video"),
57+
SplashFeature(title: "Feature 2", icon: "waveform")
58+
],
59+
footer: "Terms and conditions apply.",
60+
cta: "Accept Offer",
61+
secondaryCta: "See All Plans",
62+
secondaryAction: {
63+
print("Secondary action tapped")
64+
}
65+
) {
66+
print("Primary action tapped")
67+
}
68+
```
69+
70+
<img src="https://github.com/user-attachments/assets/44f9aeef-7906-4251-b338-f9504b30b278" width="350" />
71+
72+
## 已知問題
73+
- 只支援 iOS 18+，利用咗最新嘅 SwiftUI `TextRenderer` 同視覺效果 API。
74+
- 尺寸調整：輪播模式針對 Pro/Pro Max 優化。靜態模式包含 ScrollView，可以應付細機同埋唔同長度嘅內容。
75+
76+
## 版權
77+
App Store 螢幕截圖 © 2025 Apple Inc.
78+
79+
## 參考
80+
[Creating visual effects with SwiftUI - Apple Developer](https://developer.apple.com/documentation/swiftui/creating-visual-effects-with-swiftui)
81+
82+
## X 相關貼文
83+
https://x.com/1998design/status/1888641485303878110 <br>
84+
https://x.com/1998design/status/1888945523845140677
85+
86+
## 組合推薦
87+
配合 [SwiftNEWKit](https://github.com/1998code/SwiftNEWKit) 一齊用，效果加倍！
88+
<br><br>
89+
<img height=300 src="https://github.com/user-attachments/assets/cc88b31d-326f-4a43-9e6a-5f583fcf153b" />
90+
91+
## 許可證
92+
MIT
93+
94+
## 贊助商
95+
<a href="https://m.do.co/c/ce873177d9ab">
96+
<img src="https://opensource.nyc3.cdn.digitaloceanspaces.com/attribution/assets/SVG/DO_Logo_horizontal_blue.svg" width="201px">
97+
</a>

‎Readme/README_JP.md‎

Lines changed: 97 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,97 @@
1+
# SplashScreenKit
2+
### SwiftUIのための新しいスプラッシュ画面
3+
4+
[English](../README.md) | [繁體中文](./README_TW.md) | [简体中文](./README_CN.md) | [香港粵語](./README_HK.md) | [한국어](./README_KR.md)
5+
6+
<img width="1585" alt="Screenshot 2025-02-10 at 8 18 53 PM" src="https://github.com/user-attachments/assets/7f35a079-f74d-4c35-8f25-ea3239cc645f" />
7+
8+
## バージョン
9+
**2.2.0 (安定版リリース)** <br>
10+
*カクつきのない、高性能なインタラクションに最適化されています。*
11+
12+
- **シームレスな無限カルーセル:** 新しい仮想インデックスロジックにより「カードが飛んでいく」現象を防ぎ、スムーズな無限回転を保証します。
13+
- **パフォーマンス最適化:** Metal加速レンダリング（`drawingGroup`）と`RunLoop`による効率的なフレーム更新。
14+
- **慣性スクロール:** ネイティブの減速感を持つ、ベロシティベースの滑らかなインタラクティブジェスチャ。
15+
- **AsyncImage サポート:** ラグのないリモート画像読み込みのための事前検証済みURL処理。
16+
- **2つの表示モード:** 動的な `.carousel` モードとエレガントな `.static` レイアウトから選択可能。
17+
- **高度なテキスト効果:** SwiftUI 6.0の機能を活用した美しいテキストレンダリングとトランジション。
18+
19+
## 環境 / テスト済み
20+
- 📲 iOS 18.0以上必須
21+
- Swift 6.0
22+
- Xcode 16.0以上
23+
24+
## 使い方
25+
パッケージをプロジェクトに追加してください: ```https://github.com/1998code/19-Splash-Screen-for-SwiftUI```
26+
27+
### カルーセルモード (デフォルト)
28+
画像を回転させるクラシックなインタラクティブ体験。
29+
```swift
30+
SplashScreen(
31+
images: [
32+
Photo("ImageName1"),
33+
Photo("https://example.com/image.jpg") // リモートURLもサポート！
34+
],
35+
title: "Welcome to",
36+
product: "Apple TV",
37+
caption: "Browse all movies, TV shows, and more.",
38+
cta: "Watch Now"
39+
) {
40+
print("Action Button Tapped")
41+
}
42+
```
43+
44+
<img src="https://github.com/user-attachments/assets/28c8a5dc-cb8c-4aa4-b0a8-d7139ce3cefc" width="350" />
45+
46+
### スタティックモード (新規)
47+
製品紹介に最適な、クリーンでスクロール可能なレイアウト。
48+
```swift
49+
SplashScreen(
50+
mode: .static,
51+
images: [Photo("https://url.to/header_image.jpg")],
52+
title: "Creator Studio",
53+
product: "3 months of Creator Studio for free.",
54+
caption: "Bring your vision to life with powerful apps.",
55+
features: [
56+
SplashFeature(title: "Feature 1", icon: "video"),
57+
SplashFeature(title: "Feature 2", icon: "waveform")
58+
],
59+
footer: "Terms and conditions apply.",
60+
cta: "Accept Offer",
61+
secondaryCta: "See All Plans",
62+
secondaryAction: {
63+
print("Secondary action tapped")
64+
}
65+
) {
66+
print("Primary action tapped")
67+
}
68+
```
69+
70+
<img src="https://github.com/user-attachments/assets/44f9aeef-7906-4251-b338-f9504b30b278" width="350" />
71+
72+
## 既知の問題
73+
- 最新のSwiftUI `TextRenderer` および視覚効果APIを活用しているため、iOS 18以降のみ対応しています。
74+
- リサイズ: カルーセルモードはPro/Pro Maxに最適化されています。スタティックモードはScrollViewを含んでおり、より小さなデバイスや様々なコンテンツの長さに対応しています。
75+
76+
## 著作権
77+
App Store Screenshots © 2025 Apple Inc.
78+
79+
## 参照
80+
[Creating visual effects with SwiftUI - Apple Developer](https://developer.apple.com/documentation/swiftui/creating-visual-effects-with-swiftui)
81+
82+
## X (旧Twitter) の関連投稿
83+
https://x.com/1998design/status/1888641485303878110 <br>
84+
https://x.com/1998design/status/1888945523845140677
85+
86+
## 組み合わせ
87+
[SwiftNEWKit](https://github.com/1998code/SwiftNEWKit) と一緒に使うと、2倍の効果があります！
88+
<br><br>
89+
<img height=300 src="https://github.com/user-attachments/assets/cc88b31d-326f-4a43-9e6a-5f583fcf153b" />
90+
91+
## ライセンス
92+
MIT
93+
94+
## サポート
95+
<a href="https://m.do.co/c/ce873177d9ab">
96+
<img src="https://opensource.nyc3.cdn.digitaloceanspaces.com/attribution/assets/SVG/DO_Logo_horizontal_blue.svg" width="201px">
97+
</a>

0 commit comments

Comments
 (0)