lehttp_overrides

插件介绍

基于插件公开信息、社区数据与项目使用情况整理的选型参考。

一个专为解决 Android 7.1.1 及更早版本上 Let's Encrypt 引起的 SSL 证书问题而设计的 Flutter 包。它提供必要的 HTTP 覆盖，以确保在较旧的 Android 设备上保持安全连接功能正常。该包对于目标为遗留 Android 系统的应用程序特别有用，因为在这些系统中，由于信任存储过时，证书验证会失败。它可与现有 HTTP 客户端无缝集成，配置需求极少。由 netfarm.it 维护，支持包括 Android、iOS、macOS、Windows 和 Linux 在内的多个平台。

适合场景

修复 Android 7.1.1 及以下版本的 SSL 错误
在旧版 Android 设备上启用安全 API 调用
确保与 Let's Encrypt 证书的兼容性
在企业或面向公众的应用中支持较旧的设备
跨平台版本保持 HTTPS 连接

主要特点

Android 7.1.1 的内置 SSL 证书修复
所需设置最少
跨平台支持
与标准 HTTP 客户端兼容
开源且持续维护

适合对象

面向较旧 Android 设备的开发者
在旧系统上需要可靠HTTPS的应用程序
使用 Let's Encrypt 证书的项目
维护向后兼容性的团队
具有多样化设备机队的企业应用

使用建议

Android 8.0 及以上版本不需要
可能需要在较旧的设备上进行额外测试
仅限 Android 上的 SSL 相关问题
不影响iOS或其他平台
如果需要，最好与正确的证书固定结合使用

原始 README

以下为关联源码仓库的 README 原文快照，最新内容请访问源码仓库。

A Flutter package to resolve Let's Encrypt SSL certificate problems with Android 7.1.1 and below

More information here (Italian)

Getting Started

To enable the fix you need to add this line at the beginning of your project:

import 'package:lehttp_overrides/lehttp_overrides.dart';

void main() {
  if (Platform.isAndroid) {
    HttpOverrides.global = LEHttpOverrides();
  }
  runApp(const MyApp());
}

This works if you are using ISRG Root X1 certificate path by adding ISRG Root X1 CA to certificate store.

This is harmless on Android > 7.1.1 because the system already has it.

An optional parameter of the constructor allowExpiredDSTX3 (defaults: false) allows to accept as valid the DST Root CA X3 expired certificate. OpenSSL >= 1.1 should not trigger this check, but old Android versions still need it.

My suggestion is to leave this disabled and use ISRG Root X1 certiicate path.

搜索插件、代码仓与 APP 分类