@sentry/craft 0.27.6 → 0.29.0

package/CHANGELOG.md

@@ -1,5 +1,24 @@
 # Changelog
 
+## 0.29.0
+
+### Various fixes & improvements
+
+- feat: Adds pub.dev target for Dart and Flutter (#353) by @kamilogorek
+- misc: Add explanatory code comments and minor refactor for Maven target (#354) by @kamilogorek
+
+## 0.28.1
+
+### Various fixes & improvements
+
+- fix: Correctly set auth header and content-type for Nexus requests (#352) by @kamilogorek
+
+## 0.28.0
+
+### Various fixes & improvements
+
+- feat: Publish maven packages without use of Gradle (#351) by @kamilogorek
+
 ## 0.27.6
 
 ### Various fixes & improvements

package/README.md

@@ -54,6 +54,7 @@ then enforces a specific workflow for managing release branches, changelogs, art
   - [Unity Package Manager (`upm`)](#unity-package-manager-upm)
   - [Maven central (`maven`)](#maven-central-maven)
   - [Symbol Collector (`symbol-collector`)](#symbol-collector-symbol-collector)
+  - [pub.dev (`pub-dev`)](#pubdev-pub-dev)
 - [Integrating Your Project with `craft`](#integrating-your-project-with-craft)
 - [Pre-release (Version-bumping) Script: Conventions](#pre-release-version-bumping-script-conventions)
 - [Post-release Script: Conventions](#post-release-script-conventions)
@@ -1013,14 +1014,13 @@ Note: in order to see the output of the commands, set the [logging level](#loggi
 
 **Configuration**
 
-| Option              | Description                                                           |
-| ------------------- | --------------------------------------------------------------------- |
-| `gradleCliPath`     | Path to the Gradle CLI. It must be executable by the calling process. |
-| `mavenCliPath`      | Path to the Maven CLI. It must be executable by the calling process.  |
-| `mavenSettingsPath` | Path to the Maven `settings.xml` file.                                |
-| `mavenRepoId`       | ID of the Maven server in the `settings.xml`.                         |
-| `mavenRepoUrl`      | URL of the Maven repository.                                          |
-| `android`           | Android configuration, see below.                                     |
+| Option              | Description                                                          |
+| ------------------- | -------------------------------------------------------------------- |
+| `mavenCliPath`      | Path to the Maven CLI. It must be executable by the calling process. |
+| `mavenSettingsPath` | Path to the Maven `settings.xml` file.                               |
+| `mavenRepoId`       | ID of the Maven server in the `settings.xml`.                        |
+| `mavenRepoUrl`      | URL of the Maven repository.                                         |
+| `android`           | Android configuration, see below.                                    |
 
 If your project isn't related to Android, you don't need this configuration and
 can set the option to `false`. If not, set the following nested elements:
@@ -1034,7 +1034,6 @@ can set the option to `false`. If not, set the following nested elements:
 ```yaml
 targets:
   - name: maven
-    gradleCliPath: ./gradlew
     mavenCliPath: scripts/mvnw.cmd
     mavenSettingsPath: scripts/settings.xml
     mavenRepoId: ossrh
@@ -1047,7 +1046,6 @@ targets:
 ```yaml
 targets:
   - name: maven
-    gradleCliPath: ./gradlew
     mavenCliPath: scripts/mvnw.cmd
     mavenSettingsPath: scripts/settings.xml
     mavenRepoId: ossrh
@@ -1081,6 +1079,41 @@ targets:
     bundleIdPrefix: android-ndk-
 ```
 
+### pub.dev (`pub-dev`)
+
+Pushes a new Dart or Flutter package to [pub.dev](https://pub.dev/).
+
+Because there is [no automated way](https://github.com/dart-lang/pub-dev/issues/5388) to login and obtain required tokens, you need to perform a valid release beforehand, for every package that you configure. This will open up your browser and use Google's OAuth to log you in, and generate an appropriate file with stored credentials.
+
+Based on your environment, you can find this file at `$HOME/Library/Application\ Support/dart/pub-credentials.json` for OSX or `$HOME/.config/dart/pub-credentials.json` for Linux.
+
+For this target to work correctly, either `dart` must be installed on the system or a valid `dartCliPath` must be provided.
+
+**Environment**
+
+| Name                   | Description                                                  |
+| ---------------------- | ------------------------------------------------------------ |
+| `PUBDEV_ACCESS_TOKEN`  | Value of `accessToken` obtained from `pub-credentials.json`  |
+| `PUBDEV_REFRESH_TOKEN` | Value of `refreshToken` obtained from `pub-credentials.json` |
+
+**Configuration**
+
+| Option        | Description                                                                                                                                                                                     |
+| ------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `dartCliPath` | **optional** Path to the Dart CLI. It must be executable by the calling process. Defaults to `dart`.                                                                                            |
+| `packages`    | **optional** List of directories to be released, relative to the root. Useful when a single repository contains multiple packages. When skipped, root directory is assumed as the only package. |
+
+**Example**
+
+```yaml
+targets:
+  - name: pub-dev
+    packages:
+      uno:
+      dos:
+      tres:
+```
+
 ## Integrating Your Project with `craft`
 
 Here is how you can integrate your GitHub project with `craft`: