Pydroid3下如何为Python配置本地.tar.gz路径？pip安装报错求助

核心错误说明 #

• 下载的压缩包本身不符合pip安装要求：libwebp-1.2.0-linux-x86-64.tar.gz是x86_64架构Linux环境的原生C语言编译库，不属于pip可识别的Python格式安装包，包内没有安装流程必需的setup.py、pyproject.toml配置文件，pip执行安装时自然会抛出找不到setup.py的报错。
• 架构完全不兼容：Pydroid3的Python运行环境是aarch64-linux-android（ARM64架构安卓），下载的x86_64（桌面CPU架构）二进制文件哪怕手动解压，也无法在当前环境被Python加载运行。

可落地操作步骤 #

• 替换安装目标，不要硬装原生libwebp压缩包：Pillow 9.0+版本已经内置webp图像读写支持，Pydroid3的软件源中已经预编译好了适配ARM64安卓环境的带webp支持的Pillow包，直接执行安装命令即可：
  python -m pip install Pillow
• 针对本地.tar.gz类Python包的通用配置方案：
  1. 如果遇到的是符合pip规范、带完整安装配置文件的本地Python格式tar.gz包，先把包从公共存储路径/storage/emulated/0/Download/复制到Pydroid3的私有工作目录（比如用户主目录~/），规避安卓公共存储区的权限限制导致的解压失败，再执行pip安装命令。
  2. 如果.tar.gz是项目需要直接读取的资源文件、而非安装包，不需要移动到Python安装路径，直接在代码中通过绝对路径引用文件，或者通过sys.path.append("压缩包所在目录绝对路径")把目录加入Python模块搜索路径即可访问。
• 验证webp支持状态：进入Python交互环境执行测试代码

  from PIL import Image
  print(Image.registered_extensions().get('.webp', 'webp支持未生效'))
  

  输出WEBP即为配置成功。

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