-
Notifications
You must be signed in to change notification settings - Fork 33
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
feat: Unpublish rollbar_{dart,flutter} and add vendoring instructions
Since Rollbar will no longer be publishing package updates to pub.dev, it will be helpful for many users to "vendor" the Rollbar packages into their projects so that they can have full control over package versions, pull in fixes from the community, etc. For example, the rollbar_dart package on pub.dev currently has an old http dependency, even though this has already been updated on the main branch. Add instructions to the README for vendoring rollbar_flutter into a user project, and change the internal rollbar_{dart,flutter} dependencies to be "path" dependencies (pulling from within this repo) rather than "hosted" (pulling from pub.dev). Fixes #124
- Loading branch information
Showing
3 changed files
with
31 additions
and
7 deletions.
There are no files selected for viewing
This file contains 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
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -36,6 +36,35 @@ For complete usage instructions and configuration reference, see our [`rollbar-d | |
|
||
See our [Releases](https://github.com/rollbar/rollbar-flutter/releases) page for a list of all releases and changes. | ||
|
||
## Vendoring | ||
|
||
Since Rollbar will no longer be publishing package updates to pub.dev, it's | ||
recommended that you "vendor" the Rollbar packages into your project so | ||
that you can have full control over package versions, pull in fixes from | ||
the community, etc. For example, the `rollbar_dart` package on pub.dev | ||
currently has an old `http` dependency, even though this has already been | ||
updated on the `main` branch. | ||
|
||
To vendor this package in your project, it's recommended to add it as a | ||
`git` submodule. Typically you'll want to fork the repo so that you can | ||
make changes there, and use your fork for the submodule URL, like so: | ||
|
||
``` | ||
git submodule add https://github.com/<YOUR_USERNAME>/rollbar-flutter.git vendor/rollbar-flutter | ||
``` | ||
|
||
Next, remove `rollbar_flutter: ^X.X.X` from the `dependencies:` block in | ||
your `pubspec.yaml`, and add the following: | ||
|
||
```yaml | ||
dependencies: | ||
... | ||
|
||
# vendored packages | ||
rollbar_flutter: | ||
path: vendor/rollbar-flutter/rollbar_flutter | ||
``` | ||
## Help / Support | ||
If you run into any issues, please email us at [[email protected]](mailto:[email protected]). | ||
|
This file contains 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
This file contains 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