名詞糾正
- Portrait = 直向(豎屏,Home 鍵在下)
- Landscape = 橫向(橫屏,Home 鍵在左/右)
五種檢測方案對比
| 方法 | API | 優點 | 缺點 | 推薦場景 |
| 1. ViewController 生命周期 | willRotateToInterfaceOrientation:duration:
didRotateFromInterfaceOrientation: | 官方推薦、自動觸發、動畫同步 | iOS 8+ 棄用,需遷移至 viewWillTransitionToSize:withTransitionCoordinator: | 舊項目維護、簡單旋轉響應 |
| 2. 直接讀取設備方向 | UIDevice.current.orientation | 隨時可查、不依賴 VC | 啟動初期返回 UIDeviceOrientationUnknown、不反映界面實際方向(如鎖定旋轉時) | 後台任務、非 UI 邏輯判斷 |
| 3. 界面方向(推薦) | UIApplication.shared.statusBarOrientation (iOS 13-
windowScene.interfaceOrientation (iOS 13+) | 反映用戶實際看到的界面方向、支援鎖定旋轉場景 | 需在主線程、需有窗口場景上下文 | 佈局調整、UI 狀態同步 |
| 4. 螢幕 bounds 反推 | [UIScreen mainScreen].bounds / applicationFrame | 無需旋轉通知、純幾何計算 | applicationFrame 已棄用、Split View 下不可靠、無法區分左右橫屏 | 極簡邏輯、無 VC 上下文時的備選 |
| 5. 現代 Size Class 適配 | traitCollection.horizontalSizeClass / verticalSizeClass | 適配 iPad 分屏、Mac Catalyst、折疊屏、未來形態 | 學習曲線稍陡、不直接對應具體角度 | 新項目、自適應佈局、多窗口支援 |
代碼示例:現代化旋轉響應
- (void)viewWillTransitionToSize:(CGSize)size withTransitionCoordinator:(id)coordinator {
[super viewWillTransitionToSize:size withTransitionCoordinator:coordinator];
[coordinator animateAlongsideTransition:^(id context) {
// 動畫過程中同步調整佈局
[self updateLayoutForSize:size];
} completion:^(id context) {
// 旋轉完成後的收尾工作
NSLog(@"旋轉完成,新尺寸:%@", NSStringFromCGSize(size));
}];
}
- (void)updateLayoutForSize:(CGSize)size {
BOOL isLandscape = size.width > size.height;
// 根據 size 而非 orientation 調整佈局,自動適配分屏
self.collectionViewLayout.itemSize = isLandscape ? CGSizeMake(200, 150) : CGSizeMake(150, 200);
}
避坑清單
- ❌ 使用
self.interfaceOrientation(iOS 8 棄用)
- ❌ 依賴
UIDeviceOrientation 進行 UI 佈局決策
- ❌ 在
viewDidLoad 中讀取方向決定初始佈局(此时可能不準)
- ✅ 使用
viewWillTransitionToSize: + Size Class 進行自適應佈局
- ✅ 啟動時以
windowScene.interfaceOrientation 為準初始化
- ✅ 支援
supportedInterfaceOrientations 聲明支援方向