Repository navigation
Explain the apt install line of the README example and run it first - #54
Merged
Merged
Conversation
…irst The README example installs curl, git, unzip, xz-utils, zip and libglu1-mesa with apt, and did not say where the line comes from or that it is different on every system. - README.md, README_CN.md: install the packages first, because the plugin runs git while it installs, and add a paragraph that explains the line. - docs/platforms.md, docs/zh-CN/platforms.md: a "System packages" section with the source of the command (Flutter's "Install Flutter manually" guide), what each package is for, why they come before `vfox install`, and what other systems need.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
README.mdandREADME_CN.md: the example installs the system packages first, and a paragraph under it says what that line is: not a vfox command, the packages that Flutter's installation guide asks for on Linux, written forapt(Ubuntu and other Debian-based distributions), and different on every system. It links to the new section below.docs/platforms.mdanddocs/zh-CN/platforms.md: a new "System packages" section.apt-getas its example. The README usesaptand--assume-yesand has noapt-get updateline, so the section says to update the package lists in a fresh container.vfox install.platforms.mdpoints to the section instead of listing the packages.Why the order of the example changed
lib/manifest.luareads the SDK's commit withgit rev-parse HEADwhen it installs. Withoutgit, the source installs (Linux ARM64, Windows ARM64, OpenHarmony builds) fail, and any other install succeeds with a.vfox-manifestthat has no commit, so the drift check of flutter-upgrade.md never warns. The example used to runapt installaftervfox install.Checked
ubuntu:26.04container the README line fails withoutapt update(Unable to locate package curl) and installs all six packages after it.bin/internal/shared.sh(git),bin/internal/update_dart_sdk.sh(curl,unzip) andOperatingSystemUtils.unzipof the Flutter tool, and from vfox'sdecompressor.go, which unpacks.tar.xzitself, soxz-utilsis there for Flutter's manual steps. Flutter's current guide does not say whyzipandlibglu1-mesaare listed. Its 2023 and 2024 versions (Wayback copies) listzipamong the tools Flutter relies on, and say thatflutter testneedslibGLU.so.1, whichmesa-libGLUprovides on Fedora. The section words these as "earlier versions of Flutter's guide".#download-prerequisitesanchor exists on docs.flutter.dev and docs.flutter.cn, the Git for Windows link answers, and the links to the new heading resolve in both languages. The English and Chinese sections have the same structure.changes.mdentry: it lists what users notice of a release.