Android 7/8无法启动Kotlin应用排查求助（附完整代码）

一、先查build.gradle的依赖与编译配置 #

• 第三方库版本过高：很多新库默认放弃了API23/26的支持，比如AndroidX、Jetpack组件。比如androidx.core:core-ktx如果用了1.7.0+，可能在Android7上跑不起来。把依赖降到兼容API23的稳定版：

  dependencies {
      implementation 'androidx.core:core-ktx:1.6.0'
      implementation 'androidx.appcompat:appcompat:1.4.2'
      implementation 'com.google.android.material:material:1.4.0'
      // 其他依赖挨个核对，换成支持minSdk23的版本
  }
  

• Java版本设置不对：Android7/8只支持Java8，如果你的build.gradle里设了Java11或更高，直接崩。检查模块级build.gradle：

  android {
      compileOptions {
          sourceCompatibility JavaVersion.VERSION_1_8
          targetCompatibility JavaVersion.VERSION_1_8
      }
      kotlinOptions {
          jvmTarget = '1.8'
      }
  }
  

二、检查AndroidManifest.xml的配置 #

• 主Activity的exported属性：虽然API31+强制要求，但低版本系统如果设成false或者没设，会导致启动失败。确保主Activity的配置是：

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

• 权限声明要兼容：别直接加API26+才有的权限，比如ACCESS_BACKGROUND_LOCATION，要给它加版本限制：

  <uses-permission android:name="android.permission.ACCESS_BACKGROUND_LOCATION" android:minSdkVersion="26" />
  

三、MainActivity里的代码踩坑点 #

• 调用了高API专属方法：比如API26+的NotificationManager.createNotificationChannel()，API28+的Context.getDisplay()，没做版本判断直接调用会炸。加个版本判断：

  if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
      // 这里放API26+的代码，比如创建通知渠道
  }
  

• Kotlin版本或特性问题：高版本Kotlin的某些特性编译后在低版本Android上跑不起来，把Kotlin插件版本降到1.6.21试试（这个版本兼容API23很稳）。

四、activity_main.xml的布局问题 #

• 用了高版本控件/属性：比如Material3的控件、ConstraintLayout的新属性（比如layout_constraintGuide_percent在旧库版本里可能不兼容）。换成兼容的版本：
  • ConstraintLayout用2.1.4：implementation 'androidx.constraintlayout:constraintlayout:2.1.4'
  • 别用Material3的主题或控件，改用Material2的Theme.MaterialComponents.Light.DarkActionBar

五、最关键的一步：看崩溃日志 #

直接连Android7/8的设备，打开Android Studio的Logcat，过滤Error或Crash，找到具体的崩溃栈，比如是哪个类哪个方法抛的异常，这才是最快定位问题的办法。另外可以试试清理项目缓存：File > Invalidate Caches... > Invalidate and Restart，有时候缓存也会搞出奇怪的兼容问题。

内容的提问来源于stack exchange，提问作者Amir Elahi