Flutter连接电脑调试正常，Debug APK安装后无法启动求助

我想给朋友分发应用的本地版本，于是将Debug APK发给他们，但对方安装后启动应用时，要么直接跳转到设置，要么完全无法打开。

以下是我的pubspec.yaml文件内容：

name: raydeo
description: A new Flutter project.

publish_to: "none"

version: 1.0.0+1

environment:
  sdk: ">=2.17.6 <3.0.0"

dependencies:
  flutter:
    sdk: flutter
  cupertino_icons: ^1.0.2
  bloc: ^7.1.0
  equatable: ^2.0.3
  google_fonts: ^3.0.1
  http: ^0.13.5
  shared_preferences: ^2.0.15
  intl_phone_field: ^3.1.0
  firebase_core: ^1.20.0
  firebase_auth: ^3.6.2
  otp_text_field: ^1.1.3
  hive: ^2.2.3
  hive_flutter: ^1.1.0
  mqtt5_client: ^3.3.1
  hive_generator: ^1.1.3
  build_runner: ^2.2.0
  flutter_bloc: ^7.3.3
  firebase_dynamic_links: ^4.3.4
  share_plus: ^4.0.10+1

dev_dependencies:
  flutter_test:
    sdk: flutter
  mockito: ^5.3.0
  flutter_lints: ^2.0.0

flutter:
  uses-material-design: true

我的flutter doctor检测结果正常，使用的是M1 Mac。

核心问题与解决步骤 #

1. Debug APK的本质局限 #

Debug版本APK不适合对外分发：

• 自带调试签名证书，多数设备的系统安全机制会判定其为未受信任应用，直接拦截启动或跳转设置页
• 内置大量调试组件与日志输出，部分厂商系统会限制这类应用的运行权限

2. 构建Release版本APK（必做） #

这是解决问题的核心方案，步骤如下：

• 生成签名密钥（首次操作）：

  keytool -genkey -v -keystore ~/key.jks -keyalg RSA -keysize 2048 -validity 10000 -alias key
  

• 配置密钥信息：在项目根目录创建android/key.properties文件，填入：

  storePassword=你的密钥库密码
  keyPassword=你的密钥密码
  keyAlias=key
  storeFile=../key.jks
  

• 修改Android构建配置：打开android/app/build.gradle，在android块内添加签名配置：

  def keystoreProperties = new Properties()
  def keystorePropertiesFile = rootProject.file('key.properties')
  if (keystorePropertiesFile.exists()) {
      keystoreProperties.load(new FileInputStream(keystorePropertiesFile))
  }
  
  signingConfigs {
      release {
          keyAlias keystoreProperties['keyAlias']
          keyPassword keystoreProperties['keyPassword']
          storeFile keystoreProperties['storeFile'] ? file(keystoreProperties['storeFile']) : null
          storePassword keystoreProperties['storePassword']
      }
  }
  

  接着在buildTypes的release块中关联签名配置：

  buildTypes {
      release {
          signingConfig signingConfigs.release
          minifyEnabled true
          shrinkResources true
          proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
      }
  }
  

• 构建Release APK：

  flutter build apk --release
  

  生成的APK路径为build/app/outputs/flutter-apk/app-release.apk

3. Firebase依赖额外检查 #

你的项目包含Firebase组件，Release版本需确保：

• google-services.json已放置在android/app目录下
• Firebase控制台已配置该Release版本签名证书的SHA-1值（通过keytool -list -v -keystore ~/key.jks获取）

4. M1 Mac适配优化 #

若构建时出现架构相关错误，在android/app/build.gradle的android块内添加：

ndk {
    abiFilters 'armeabi-v7a', 'arm64-v8a', 'x86_64'
}

内容的提问来源于stack exchange，提问作者Shivam Kajaria