flutter packages 开发实战——发布失败问题解决

flutter packages 开发实战——发布失败问题解决

Flutter 的库是以 package 的方式来管理。Package 分为两种，Dart package（也叫 library package） 和 plugin package。当我们说 Fluter 包的时候，指的其实也是 Dart 包，它只能使用 Dart 和 Flutter 提供的 API；而当我们说 Flutter 插件时指的是后者，也就是 plugin package。Flutter 插件通常会包含平台特定的代码。对包的使用者来说，两者没有区别。

这里我们创建一个package，并发布到dart仓库上。

1、package开发过程

使用Android Studio新建一个flutter package项目

具体流程如下：

• 在菜单上选择 File -> New -> New Flutter Project。
• 在弹出的面板里选择 Flutter Package，点击 next。
• 填写package的相关信息，Project Name填入我们的项目名称即可，其他信息按需填写。

具体如下图。

具体业务开发

接下来就可以在lib/包下写我们自己package中的代码了。

本文的重点不在这儿，如需了解，具体请查看Flutter学习指南：封装 API 插件——玉刚说等资料。

2、上传信息填写

填写用户名、邮箱、个人主页信息

上传之前，我们需要完善本地的配置信息，具体在 pubspec.yaml 文件中。我们在使用as新建项目时，这个文件中已经自动生成了对应的信息，我们只需要填写用户名、个人邮箱和主页地址就好。

name: flutter_lifecycle_state
description: Make State support lifecycle method just like Android's Activity#onCreate、 Activity#onResume、Activity#onPause、Activity#onDestroy.
version: 0.0.1
author: tinytongtong<tinyvampire1102@gmail.com>
homepage: https://blog.csdn.net/qq_26287435

这里的name和description字段的值，就是新建package对话框中填写的信息。

version字段是用来发版的，每次发新版记得增加版本号。

author字段中，填写的是作者名称和可用的Google邮箱，格式是username。需要注意的是，这个gmail邮箱需要保证可用。

homepage字段，填写的是个人主页url即可，这里我填写的是我的csdn主页。

LICENSE文件

另外，发布到 Pub 上的包需要包含一个 LICENSE，关于 LICENSE 文件，最简单的方法就是在 GitHub 创建仓库的时候选中一个。

这里我是从新建的github项目中粘贴过来的。

检查包的配置

我们在项目的根目录执行以下命令，检测一下包的配置是否问题：

flutter packages pub publish --dry-run

如果没有问题，输出如下：

...

Package has 0 warnings.

发布包

发布包和上一步一样，只是少了 –dry-run 参数：

flutter packages pub publish

如果是第一次发布，会提示验证 Google 账号。google账号是以https:开头，以.email结尾的地址，防止因为地址不全导致打开页面错误。

授权后便可以继续上传，如果成功的话，会提示“Successful uploaded package”：

Looks great! Are you ready to upload your package (y/n)? y Pub needs your authorization to upload packages on your behalf. In a web browser, go to https://accounts.google.com/o/oauth2/auth?access_type=offline&approval_prompt=force&response_type=code&client_id=xxxxxxxxxxxxxx-8grd2eg9tj9f38os6f1urbcvsq399u8n.apps.googleusercontent.com&redirect_uri=http%3A%2F%2Flocalhost%3A52589&scope=https%3A%2F%2Fwww.googleapis.com%2Fauth%2Fuserinfo.email
Then click "Allow access".

Waiting for your authorization...
Successfully authorized.
Uploading...

当然了，一般情况下，你现在就是各种报错了，如果这么简单就可以成功的话，那我就不会写这篇文章了。莫慌，接着往下看。

3、发布过程中常见错误

• 去掉host文件中针对PUB_HOSTED_URL、FLUTTER_STORAGE_BASE_URL的修改。

如果你看到下图第一行所示的这个错误，此时你需要去掉官方指引里面对PUB_HOSTED_URL、FLUTTER_STORAGE_BASE_URL的修改，这些修改会导致上传pub失败。github.com/flutter/flu…

修改后的host如下:然后刷新终端。

# flutter
#export PUB_HOSTED_URL=https://pub.flutter-io.cn
#export FLUTTER_STORAGE_BASE_URL=https://storage.flutter-io.cn
export PWD=/Users/tinytongtong/Documents/workspace/flutter/sdk/flutter/bin
export PATH="${PWD}:${PATH}"

• 未开代理 一般情况下，如果你没有自备ladder的话，就会看到上传步骤卡在这儿不同了。如下所示。

tinytongtongdeMacBook-Pro% flutter packages pub publish
Publishing flutter_lifecycle_state 0.0.1 to https://pub.flutter-io.cn:
...
Looks great! Are you ready to upload your package (y/n)? y
Uploading...

你此时敲击下回车键，就会出现如下错误提示：

Looks great! Are you ready to upload your package (y/n)? y
Uploading...

Unhandled exception:
SocketException: Write failed (OS Error: Broken pipe, errno = 32), port = 0
#0      _rootHandleUncaughtError.<anonymous closure> (dart:async/zone.dart:1112:29)
#1      _microtaskLoop (dart:async/schedule_microtask.dart:41:21)
#2      _startMicrotaskLoop (dart:async/schedule_microtask.dart:50:5)
#3      _runPendingImmediateCallback (dart:isolate/runtime/libisolate_patch.dart:115:13)
#4      _RawReceivePortImpl._handleMessage (dart:isolate/runtime/libisolate_patch.dart:172:5)
tinytongtongdeMacBook-Pro% 

这个错误根源是没有开代理。

• 开了lantern代理。

如果你已经开了代理，比方说lantern，你可能就会看到如下错误：

bogon% flutter packages pub publish
Publishing flutter_lifecycle_state 0.0.1 to https://pub.dartlang.org:
...

Looks great! Are you ready to upload your package (y/n)? y
Pub needs your authorization to upload packages on your behalf.
In a web browser, go to https://accounts.google.com/o/oauth2/auth?access_type=xx1urbcvsq39xxe=https%3A%2F%2Fwww.googleapis.com%2Fauth%2Fuserinfo.email
Then click "Allow access".

Waiting for your authorization...
Authorization received, processing...
It looks like accounts.google.com is having some trouble.
Pub will wait for a while before trying to connect again.
OS Error: Operation timed out, errno = 60, address = accounts.google.com, port = 58913
pub finished with exit code 69
bogon%

或者下面这种：

Waiting for your authorization...
Authorization received, processing...
Connection closed before full header was received
pub finished with exit code 69

这两个错误产生的根源是，你需要给终端设置代理，也就是命令行代理。

4、最终解决方式——命令行翻墙工具

更新：使用lantern给终端设置代理请移步mac中使用lantern给终端设置代理.

这里推荐一种解决方式：mac端可使用proxifier + ss的方式。

Proxifier+Shadowshocks系统全局代理的正确姿势

ss X

按照教程下载配置即可。

命令行代理成功校验方式：

以 mac 为例 你输入curl google.com,如果有成功的回文(一个 html 格式的文本信息)说明成功了,如果没有就说明你的终端还在墙内,你需要自行保证 curl 能连接成功

下面这个是我在项目根目录下执行curl google.com的结果，说明成功了

tinytongtongdeMacBook-Pro% curl google.com            
<HTML><HEAD><meta http-equiv="content-type" content="text/html;charset=utf-8">
<TITLE>301 Moved</TITLE></HEAD><BODY>
<H1>301 Moved</H1>
The document has moved
<A HREF="http://www.google.com/">here</A>.
</BODY></HTML>
tinytongtongdeMacBook-Pro% 

5、一次成功上传的示例

在所有的问题都解决之后，再次flutter packages pub publish命令，输出如下：

tinytongtongdeMacBook-Pro% flutter packages pub publish
Publishing flutter_lifecycle_state 0.0.2 to https://pub.dartlang.org:
|-- .gitignore
|-- .idea
|   |-- codeStyles
|   |   '-- Project.xml | |-- dbnavigator.xml | |-- encodings.xml | |-- libraries | | |-- Dart_Packages.xml | | |-- Dart_SDK.xml | | '-- Flutter_Plugins.xml
|   |-- markdown-navigator
|   |   '-- profiles_settings.xml | |-- markdown-navigator.xml | |-- misc.xml | |-- modules.xml | |-- vcs.xml | '-- workspace.xml
|-- .metadata
|-- CHANGELOG.md
|-- LICENSE
|-- README.md
|-- android
|   |-- app
|   |   '-- src | | '-- main
|   |           '-- java | | '-- io
|   |                   '-- flutter | | '-- plugins
|   |                           '-- GeneratedPluginRegistrant.java | '-- local.properties
|-- lib
|   '-- flutter_lifecycle_state.dart |-- pubspec.yaml '-- test
    '-- flutter_lifecycle_state_test.dart Looks great! Are you ready to upload your package (y/n)? y Uploading... Successfully uploaded package. tinytongtongdeMacBook-Pro% 

发布成功后，你的gmail就会收到通知邮件了，邮件中有你项目的链接，如下所示：

参考

Flutter学习指南：封装 API 插件——玉刚说

flutter pub 发布失败

Failed to upload the package #16658

Publish plugin in china #17070

zhuanlan.zhihu.com/p/60136574