为何无法在Android Manifest的activity中添加layout标签？（PIP配置场景）

嘿，这个问题我之前也碰到过，其实根源出在API版本的不匹配上！

为什么会报错？ #

画中画（Picture-in-Picture）是Android 8.0（API Level 26）才正式引入的系统功能，而你当前的compileSdkVersion是25，这意味着Android Studio的编译工具只会识别API 25及以下的Manifest标签——layout标签是API 26为PIP新增的配置项，所以编辑器自然会提示“Element layout is not allowed here”，甚至无法识别这个标签。

正确的解决步骤 #

要顺利配置PIP功能，你需要按以下步骤调整项目配置：

1. 升级编译和目标SDK版本
   打开你的build.gradle（Module级别的文件），将相关版本升级到26或更高：

   android {
       compileSdkVersion 26 // 至少26，建议用更高的稳定版
       buildToolsVersion "26.0.2" // 对应compileSdk的版本
   
       defaultConfig {
           minSdkVersion 9 // 这个可以保留，但PIP仅在API26+生效
           targetSdkVersion 26 // 建议升到26+，以适配PIP的系统行为
       }
   }
   

   同步项目后，Android Studio就能识别PIP相关的Manifest标签了。

2. 正确配置Manifest中的Activity
   在需要支持PIP的activity标签内，添加PIP相关配置：

   <activity
       android:name=".YourPIPActivity"
       android:supportsPictureInPicture="true"
       android:configChanges="screenSize|smallestScreenSize|screenLayout|orientation">
   
       <!-- PIP模式下的布局配置 -->
       <layout
           android:defaultHeight="500dp"
           android:defaultWidth="300dp"
           android:gravity="bottom|end"
           android:minHeight="400dp"
           android:minWidth="250dp" />
   
       <!-- 可选：指定PIP的宽高比 -->
       <meta-data
           android:name="android.support.PICTURE_IN_PICTURE_ASPECT_RATIO"
           android:value="1.7777778" /> <!-- 16:9的比例 -->
   
       <!-- 你的intent-filter等其他配置 -->
       <intent-filter>
           <action android:name="android.intent.action.MAIN" />
           <category android:name="android.intent.category.LAUNCHER" />
       </intent-filter>
   </activity>
   

3. 代码中兼容低版本系统
   因为你的minSdkVersion是9，所以在调用PIP相关API时，必须做版本判断：

   if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
       // 进入PIP模式的代码
       enterPictureInPictureMode();
   } else {
       // 低版本系统的 fallback 逻辑，比如提示用户升级系统
   }
   

这样配置后，你就能正常使用PIP功能，同时也能兼容低版本的Android系统啦～

内容的提问来源于stack exchange，提问作者Massimo Milazzo