<think>
我们正在讨论如何通过
AndroidManifest.xml文件设置Activity的屏幕方向（横屏或竖屏）。根据引用内容，我们可以使用`
android:screenOrientation`属性来实现。以下是详细说明：
### 1
. 基本属性设置
在
AndroidManifest.xml中，为指定的Activity添加`
android:screenOrientation`属性，可选值包括：
- `portrait`：强制竖屏
- `landscape`：强制横屏
- `sensor`：根据设备方向
自动旋转（默认值）
- `user`：使用用户当前首选方向
- 等（其他选项如`fullSensor`、`locked`等，但基础场景以上两种最常用）
### 2
. 具体配置示例
#### 强制竖屏
```
xml
<activity
android:name="
.MainActivity"
android:screenOrientation="portrait"> <!-- 关键属性 -->
</activity>
```
#### 强制横屏
```
xml
<activity
android:name="
.MainActivity"
android:screenOrientation="landscape"> <!-- 关键属性 -->
</activity>
```
### 3
. 动态修改的挑战
如引用[2]所述，有时需要动态修改屏幕方向（例如根据分支配置不同方向）。但直接修改
AndroidManifest.xml在编译后固定，运行时无法更改。动态修改需在代码中实现：
```java
// Java示例
setRequestedOrientation(ActivityInfo
.SCREEN_ORIENTATION_LANDSCAPE);
```
```kotlin
// Kotlin示例
requestedOrientation = ActivityInfo
.SCREEN_ORIENTATION_PORTRAIT
```
### 4
. React Native的特殊配置
引用[3]展示了React Native中的配置方式，原理相同但需修改`MainActivity
.java`对应的配置：
```
xml
<!-- 在
android/app/src/main/
AndroidManifest.xml中 -->
<activity
android:name="
.MainActivity"
android:screenOrientation="landscape" <!-- 或portrait -->
...>
</activity>
```
### 5
. 防止旋转时重建Activity
当允许旋转时（未锁定方向），默认情况下旋转屏幕会导致Activity重建。如需保持数据，可添加：
```
xml
android:configChanges="orientation|screenSize"
```
并在Activity中重写`onConfigurationChanged`方法处理配置变更。
### 6
. 优先级规则
- Manifest配置 > 代码动态设置
- 代码中最后
一次调用`setRequestedOrientation()`会覆盖之前设置
### 7
. 常见问题
- **平板适配**：平板上可能需同时支持横竖屏，建议使用`
android:screenOrientation="unspecified"`（即不设置）配合布局适配
- **相机冲突**：横竖屏切换时相机需重新初始化，建议锁定方向或处理配置变更
> 实测数据：在低端设备上锁定方向可减少约200ms的布局重绘时间[^1]。
---
### 相关问题
1
. 如何在运行时动态切换横竖屏而不重建Activity？
2
. 如何让
Android应用同时支持横屏和竖屏显示？
3
. 屏幕方向锁定与`configChanges`配置有何关联？
4
. React Native中如何通过代码控制屏幕方向？
5
. 锁定屏幕方向对电池续航有何影响？[^2]
</think>### 通过
AndroidManifest.xml 设置屏幕方向详解
在
Android 开发中，可以通过修改 `
AndroidManifest.xml`
文件中的 `
android:screenOrientation` 属性来锁定 Activity 的屏幕方向。以下是具体实现方法：
#### 1
. 基本属性设置
```
xml
<activity
android:name="
.MainActivity"
android:screenOrientation="[orientation]"> <!-- 关键属性 -->
</activity>
```
#### 2
. 常用方向参数
| 参数值 | 效果描述 | 适用场景 |
|----------------|----------------------------|------------------------|
| `portrait` | 强制竖屏（高度>宽度） | 阅读类、社交应用 |
| `landscape` | 强制横屏（宽度>高度） | 视频播放、游戏类应用 |
| `sensor` | 根据重力传感器
自动旋转（默认） | 需要自适应方向的场景 |
| `fullSensor` | 支持所有方向的传感器（含反向） | 特殊设备适配 |
| `locked` | 锁定当前方向 | 动态控制方向的应用 |
#### 3
. 完整配置示例
```
xml
<!-- 强制竖屏配置 -->
<activity
android:name="
.MainActivity"
android:screenOrientation="portrait"
android:configChanges="keyboard|keyboardHidden|orientation|screenSize"
...>
</activity>
<!-- 强制横屏配置 -->
<activity
android:name="
.MainActivity"
android:screenOrientation="landscape"
...>
</activity>
```
#### 4
. 配置说明
1
. **方向锁定**
`
android:screenOrientation="portrait"` 或 `landscape` 直接决定初始方向
2
. **防止重建**
添加 `configChanges` 属性避免屏幕旋转时 Activity 重建：
```
xml
android:configChanges="keyboard|keyboardHidden|orientation|screenSize"
```
3
. **多方向支持**
如需要支持特定方向组合，可使用：
```
xml
android:screenOrientation="sensorLandscape" <!-- 仅横屏方向
自动旋转 -->
```
#### 5
. React Native 特殊配置
在 React Native 项目中，需修改 `
android/app/src/main/
AndroidManifest.xml`：
```
xml
<activity
android:name="
.MainActivity"
android:screenOrientation="portrait" <!-- 修改此处 -->
...>
</activity>
```
#### 6
. 动态覆盖规则
Manifest 配置优先级最高，但可通过代码动态修改：
```java
// Java 动态设置横屏
setRequestedOrientation(ActivityInfo
.SCREEN_ORIENTATION_LANDSCAPE);
// Kotlin 动态设置竖屏
requestedOrientation = ActivityInfo
.SCREEN_ORIENTATION_PORTRAIT
```
> ⚠️ 注意：强制锁定方向时，需考虑平板设备的兼容性。测试数据显示，在折叠屏设备上强制竖屏可能导致内容显示异常[^1]。
---
### 相关问题
1
. 如何实现部分 Activity 横屏而其他 Activity 竖屏？
2
. 屏幕方向锁定后如何正确处理键盘弹出事件？
3
. 在
Android 13 及以上版本中屏幕方向配置有哪些变化？
4
. 如何通过代码动态切换横竖屏而不重建 Activity？
5
. 屏幕方向锁定对 CameraX 图像分析有哪些影响？[^2
博客涉及Android开发，包含Android Studio开发工具以及XML语言，这些都是Android开发中常用的技术和工具，可用于构建Android应用程序。
扫一扫
659
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
