多APK配置异常：三星S21 Ultra误下平板APK，求Manifest参数排查

我的应用采用多APK分发机制，但用户在高端手机三星S21 Ultra上从Google Play Store下载时，推送的却是平板版本APK。需要排查Manifest文件中缺失的设备过滤参数，当前使用的Manifest配置如下：

1. 手机Manifest #

<?xml version="1.0"    encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="">
    <uses-feature android:name="android.hardware.screen.portrait" />

    <application
        android:name="androidx.multidex.MultiDexApplication"
        android:networkSecurityConfig="@xml/network_security_config">
        <meta-data
            android:name="com.google.android.gms.ads.AD_MANAGER_APP"
            android:value="true" />
        <meta-data android:name="android.max_aspect"
            android:value="2.4"/>

        <activity
            android:name=""
            android:configChanges="keyboard|keyboardHidden|orientation|screenLayout|uiMode|screenSize|smallestScreenSize"
            android:exported="true"
            android:launchMode="singleTask"
            android:resizeableActivity="false"
            android:screenOrientation="portrait"
            android:maxAspectRatio="2.4">
            <!-- API >= 13, screenSize must be specified with orientation -->
            <intent-filter>
                <action android:name="android.provider.Settings.ACTION_ADD_ACCOUNT" />
                <action android:name="" />

                <category android:name="android.intent.category.DEFAULT" />
            </intent-filter>

            <intent-filter>
                <action android:name="android.intent.action.MAIN" />
                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>

        </activity>

        <activity
            android:name=""
            android:configChanges="keyboard|keyboardHidden|orientation"
            android:screenOrientation="portrait"
            android:theme="@android:style/Theme.NoTitleBar.Fullscreen" />
    </application>

    <supports-screens
        android:smallScreens="true"
        android:normalScreens="true"
        android:largeScreens="false"
        android:xlargeScreens="false"
        android:anyDensity="true"
        android:requiresSmallestWidthDp="320" />
</manifest>

2. 平板Manifest #

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
      package="">
  <uses-feature android:name="android.hardware.screen.landscape" />
  <application android:networkSecurityConfig="@xml/network_security_config">

    <meta-data
        android:name="com.google.android.gms.ads.AD_MANAGER_APP"
        android:value="true"/>
    <meta-data android:name="android.max_aspect"
        android:value="1.7"/>
    <activity android:name="" android:launchMode="singleTask"
       android:screenOrientation="landscape" android:configChanges="keyboard|keyboardHidden|orientation|screenLayout|uiMode|screenSize|smallestScreenSize"
        android:resizeableActivity="false" android:exported="true"
        android:maxAspectRatio="1.7">
      <!-- API >= 13, screenSize must be specified with orientation -->
      <intent-filter>
        <action android:name="android.provider.Settings.ACTION_ADD_ACCOUNT"/>
        <action android:name=""/>
        <category android:name="android.intent.category.DEFAULT"/>
      </intent-filter>
      
      <intent-filter>
        <action android:name="android.intent.action.MAIN"/>
        <category android:name="android.intent.category.LAUNCHER"/>
      </intent-filter>
    </activity>

    <activity android:name=""
       android:theme="@android:style/Theme.NoTitleBar.Fullscreen"
       android:screenOrientation="landscape"
       android:configChanges="keyboard|keyboardHidden|orientation"/>

  </application>

  <supports-screens
      android:smallScreens="false"
      android:normalScreens="false"
      android:largeScreens="true"
      android:xlargeScreens="true"
      android:anyDensity="true"
      android:requiresSmallestWidthDp="600" />

</manifest>

3. 通用Manifest #

<?xml version="1.0"    encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    package=""
    android:installLocation="auto">

    <uses-feature android:glEsVersion="" />

    <queries>
       
    </queries>

    <application
        android:name="androidx.multidex.MultiDexApplication"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:networkSecurityConfig="@xml/network_security_config"
        android:requiredAccountType="com.google"
        android:resizeableActivity="false"
        android:roundIcon="@mipmap/ic_launcher_round"
        android:theme="@style/AppCompatTheme">
 

        <activity
            android:name=""
            android:label="sdk" />

        <!-- google play service for google ads-->
        <meta-data android:name="com.google.android.gms.version" android:value="@integer/google_play_services_version" />
        <meta-data android:name="com.google.android.gms.games.APP_ID" android:value="@string/app_id"/>
        <meta-data android:name="com.google.android.gms.ads.APPLICATION_ID" android:value=""/>

      <!-- Has Offers -->
        <receiver
            android:name="com.mobileapptracker.Tracker"
            android:exported="true">
            <intent-filter>
                <action android:name="com.android.vending.INSTALL_REFERRER" />
            </intent-filter>
        </receiver>

    </application>

    <uses-configuration android:reqTouchScreen="finger" />

    <uses-permission android:name="android.permission.INTERNET" />
    <uses-permission android:name="android.permission.WAKE_LOCK" android:maxSdkVersion="25"/>
    <uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED" tools:node="remove" />
    <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" tools:node="remove" />
    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
    <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
    <uses-permission android:name="android.permission.MANAGE_ACCOUNTS" />

    <!-- Required permission to use in-app billing. -->
    <uses-permission android:name="com.android.vending.BILLING" />
    <uses-permission android:name="com.android.vending.CHECK_LICENSE" />
    <!--<uses-permission android:name="com.google.android.c2dm.permission.RECEIVE" />-->
    <uses-permission android:name="android.permission.USE_CREDENTIALS" />
    <!-- Cloud to Device Messaging permissions -->
    <uses-permission android:name="android.permission.POST_NOTIFICATIONS"/>
</manifest>

问题根源 #

1. 大屏手机被排除在手机APK兼容范围外
   三星S21 Ultra属于大屏手机，而手机Manifest的<supports-screens>中largeScreens="false"，直接将这类设备排除在外。Play Store找不到匹配的手机APK，就会推送兼容范围更广的平板APK。

2. 横竖屏特性未设强制要求
   手机和平板Manifest仅声明支持对应方向，但未标记android:required="true"。S21 Ultra同时支持横竖屏，满足平板APK的特性要求，进一步加剧匹配混淆。

3. 缺少平板专属设备标识
   平板Manifest未要求平板专属硬件特性，无法区分大屏手机和真正的平板设备。

修复措施 #

1. 调整手机Manifest的屏幕支持配置 #

允许手机APK兼容大屏手机，同时限制最大宽度不超过平板的阈值：

<supports-screens
    android:smallScreens="true"
    android:normalScreens="true"
    android:largeScreens="true"  <!-- 兼容大屏手机 -->
    android:xlargeScreens="false"
    android:anyDensity="true"
    android:requiresSmallestWidthDp="320"
    android:largestWidthLimitDp="599" />  <!-- 最大宽度低于平板的600dp阈值 -->

2. 给平板APK添加专属特性要求 #

在平板Manifest中添加平板专属硬件特性，强制仅匹配平板设备：

<uses-feature android:name="android.hardware.type.tablet" android:required="true" />

3. 强制横竖屏特性要求 #

给手机和平板的横竖屏特性添加android:required="true"，确保只有满足对应屏幕方向要求的设备才会匹配：

• 手机Manifest：

<uses-feature android:name="android.hardware.screen.portrait" android:required="true" />

• 平板Manifest：

<uses-feature android:name="android.hardware.screen.landscape" android:required="true" />

4. 验证Play Console分发规则 #

确保手机APK的版本代码不低于平板APK，且在Play Console中配置的多APK分发规则优先给手机设备推送手机版本。

内容的提问来源于stack exchange，提问作者Singh vivek Pratap