Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/passsy/flutter_wrapper
Flutter execution wrapper which keeps the flutter version in sync for each project
https://github.com/passsy/flutter_wrapper
flutter wrapper
Last synced: 8 days ago
JSON representation
Flutter execution wrapper which keeps the flutter version in sync for each project
- Host: GitHub
- URL: https://github.com/passsy/flutter_wrapper
- Owner: passsy
- License: apache-2.0
- Created: 2018-05-14T18:20:40.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2024-03-05T23:12:23.000Z (8 months ago)
- Last Synced: 2024-08-01T12:28:24.630Z (3 months ago)
- Topics: flutter, wrapper
- Language: Dart
- Size: 107 KB
- Stars: 282
- Watchers: 12
- Forks: 39
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Funding: .github/FUNDING.yml
- License: LICENSE.txt
Awesome Lists containing this project
README
# Flutter Wrapper
`flutterw` is a tiny, open source shell script which downloads and executes the Flutter SDK with the exact version defined in your project respository.
It encourages the idea that upgrading Flutter should happen per project, not per developer.
Thus upgrading Flutter with `flutterw` automatically upgrades Flutter for your co-workers and on the CI servers.
The Flutter Wrapper will add the Flutter SDK as a git submodule to your project.
It pins the version and the channel.
This project is inspired by the gradle wrapper.
Read more on [Medium](https://medium.com/grandcentrix/flutter-wrapper-bind-your-project-to-an-explicit-flutter-release-4062cfe6dcaf)
# Install flutterw
```bash
sh -c "$(curl -fsSL https://raw.githubusercontent.com/passsy/flutter_wrapper/master/install.sh)"
```
_Open the Terminal, navigate to your project root and execute the line above._
From now on use `./flutterw` instead of `flutter`
## IDE Setup
### Use with VScode
If you're a VScode user link the new Flutter SDK path in your settings
`$projectRoot/.vscode/settings.json` (create if it doesn't exists yet)
```json
{
"dart.flutterSdkPath": ".flutter",
}
```
Commit this file to your git repo and your coworkers will automatically use `flutterw` from now on
### Use with IntelliJ / Android Studio
Go to `File > Settings > Languages & Frameworks > Flutter` and set the Flutter SDK path to `$projectRoot/.flutter`
Add this step to the onboarding guidelines of your projects because this has to be done for every developer for every project using `flutterw`.
## Tips and Tricks
### Upgrading Flutter
Flutter Wrapper doesn't require any special command to update Flutter.
Run `./flutterw channel ` to change the channel or update to the lastest version of a given channel.
```
./flutterw channel beta
./flutterw upgrade
```
Don't forget to commit the submodule changes.
### Updating flutterw
To update the flutter wrapper to the latest version run the install command again:
```bash
sh -c "$(curl -fsSL https://raw.githubusercontent.com/passsy/flutter_wrapper/master/install.sh)"
```
To update the flutter wrapper to a specific verssion, use the `-t ` (i.e. `v1.0.0`)
```bash
sh -c "curl -fsSL https://raw.githubusercontent.com/passsy/flutter_wrapper/master/install.sh" | bash /dev/stdin -t v1.0.0
```
### Uninstall flutterw
Sorry to let you go!
Removing submodules is hard, that's why I did the hard work for you.
Simply run this command from the root of your flutter project and the uninstall script will cleanup everything.
```bash
sh -c "$(curl -fsSL https://raw.githubusercontent.com/passsy/flutter_wrapper/master/uninstall.sh)"
```
Bye :wave:
### Create a new project using the flutter wrapper
You can create a new Flutter project without installing Flutter globally on your machine.
```bash
# 1. Create an empty git repo
mkdir flutter_wrapper_project && cd "$_"
git init
# 2. Install flutterw
sh -c "$(curl -fsSL https://raw.githubusercontent.com/passsy/flutter_wrapper/master/install.sh)"
# 3. Create Flutter project
./flutterw create .
./flutterw run
```
### Using flutterw on CI
Here is an example of using flutterw on a CI server.
```bash
jobs:
linux:
runs-on: ubuntu-latest
container:
# Use container with pre-installed Flutter dependencies like unzip, libglu1-mesa
image: passsy/flutterw:base-0.4.1
steps:
- uses: actions/[email protected]
- run: ./flutterw doctor -v
- run: ./flutterw pub get
- run: ./flutterw test
- run: ./flutterw analyze --fatal-infos --fatal-warnings .
macos:
runs-on: macos-latest
steps:
- uses: actions/[email protected]
- run: ./flutterw doctor -v
- run: ./flutterw pub get
- run: ./flutterw test
- run: ./flutterw analyze --fatal-infos --fatal-warnings .
```
## License
```
Copyright 2019 Pascal Welsch
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
```