Skip to content

Move BOM info to right after Quick Start #3555

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
chingor13 merged 6 commits into from
Nov 6, 2018
Merged

Move BOM info to right after Quick Start #3555

Changes from 1 commit
Commits
Show all changes
6 commits
Select commit Hold shift + click to select a range
9190e37
Move BOM info to right after Quick Start
yihanzhen Aug 10, 2018
e2846aa
split version management
yihanzhen Aug 20, 2018
61ebc91
change to old version combinations
yihanzhen Aug 24, 2018
b1e0617
Update README.md
yihanzhen Aug 24, 2018
6a03400
Merge branch 'master' into hzyi-move-bom-info-up
yihanzhen Aug 24, 2018
d855c56
Merge branch 'master' into hzyi-move-bom-info-up
chingor13 Nov 6, 2018
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
114 changes: 57 additions & 57 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -86,6 +86,63 @@ These client libraries can be used on App Engine standard for Java 8 runtime and

If you are running into problems with version conflicts, see [Version Management](#version-management).

Version Management
------------------

The easiest way to solve version conflicts is to use google-cloud's BOM. In Maven, add the following to your POM:

[//]: # ({x-version-update-start:google-cloud-bom:released})
```xml
<dependencyManagement>
<dependencies>
<dependency>
<groupId>com.google.cloud</groupId>
<artifactId>google-cloud-bom</artifactId>
<version>0.57.0-alpha</version>
<type>pom</type>
<scope>import</scope>
</dependency>
</dependencies>
</dependencyManagement>
```
[//]: # ({x-version-update-end})

This BOM is only available starting at version 0.32.0-alpha. If you are having problems with prior versions of
google-cloud, use the following table as a reference to make sure that your versions are compatible. Definitions:

This comment was marked as spam.

Sign in to view


* **alpha**: The version of any alpha package in google-cloud
* **beta**: The version of any beta package in google-cloud
* **GA**: The version of any GA package in google-cloud
* **gax**: The version of com.google.api:gax
* **gax-grpc**: The version of com.google.api:gax-grpc

Something to be aware of is that a package can be promoted from alpha -> beta or beta -> GA between versions, which
means that after a certain point for any given package, the alpha or beta version won't be valid any more.

alpha | beta | GA | gax | gax-grpc
------------- | ------------ | ---------- | ---------- | --------
0.30.0-alpha | 0.30.0-beta | 1.12.0 | 1.15.0 | 1.15.0
0.29.0-alpha | 0.29.0-beta | 1.11.0 | 1.15.0 | 1.15.0
0.28.0-alpha | 0.28.0-beta | 1.10.0 | 1.14.0 | 1.14.0
0.27.0-alpha | 0.27.0-beta | 1.9.0 | 1.13.0 | 0.30.0
0.26.0-alpha | 0.26.0-beta | 1.8.0 | 1.9.0 | 0.26.0
0.25.0-alpha | 0.25.0-beta | 1.7.0 | 1.8.1 | 0.25.1
0.24.0-alpha | 0.24.0-beta | 1.6.0 | 1.8.1 | 0.25.1
0.23.1-alpha | 0.23.1-beta | 1.5.1 | 1.8.1 | 0.25.1
0.23.0-alpha | 0.23.0-beta | 1.5.0 | 1.5.0 | 0.22.0
0.22.0-alpha | 0.22.0-beta | 1.4.0 | 1.5.0 | 0.22.0
0.21.1-alpha | 0.21.1-beta | 1.3.1 | 1.5.0 | 0.22.0
0.21.0-alpha | 0.21.0-beta | 1.3.0 | 1.5.0 | 0.22.0
0.20.3-alpha | 0.20.3-beta | 1.2.3 | 1.4.2 | 0.21.2
0.20.2-alpha | 0.20.2-beta | 1.2.2 | 1.4.2 | 0.21.2
0.20.1-alpha | 0.20.1-beta | 1.2.1 | 1.4.1 | 0.21.1
0.20.0-alpha | 0.20.0-beta | 1.2.0 | 1.3.1 | 0.20.0
0.19.0-alpha | 0.19.0-beta | 1.1.0 | 1.3.0 | 0.19.0
0.18.0-alpha | 0.18.0-beta | 1.0.2 | 1.1.0 | 0.17.0
0.17.2-alpha | 0.17.2-beta | 1.0.1 | 1.0.0 | 0.16.0
0.17.1-alpha | 0.17.1-beta | 1.0.0 | 1.0.0 | 0.16.0
0.17.0-alpha | 0.17.0-beta | 1.0.0-rc4 | 1.0.0-rc1 | 0.15.0

Specifying a Project ID
-----------------------

Expand Down Expand Up @@ -280,63 +337,6 @@ a higher priority.
are more likely to get backwards-incompatible updates. Additionally, it's possible for Alpha
libraries to get deprecated and deleted before ever being promoted to Beta or GA.

Version Management
------------------

The easiest way to solve version conflicts is to use google-cloud's BOM. In Maven, add the following to your POM:

[//]: # ({x-version-update-start:google-cloud-bom:released})
```xml
<dependencyManagement>
<dependencies>
<dependency>
<groupId>com.google.cloud</groupId>
<artifactId>google-cloud-bom</artifactId>
<version>0.57.0-alpha</version>
<type>pom</type>
<scope>import</scope>
</dependency>
</dependencies>
</dependencyManagement>
```
[//]: # ({x-version-update-end})

This BOM is only available starting at version 0.32.0-alpha. If you are having problems with prior versions of
google-cloud, use the following table as a reference to make sure that your versions are compatible. Definitions:

* **alpha**: The version of any alpha package in google-cloud
* **beta**: The version of any beta package in google-cloud
* **GA**: The version of any GA package in google-cloud
* **gax**: The version of com.google.api:gax
* **gax-grpc**: The version of com.google.api:gax-grpc

Something to be aware of is that a package can be promoted from alpha -> beta or beta -> GA between versions, which
means that after a certain point for any given package, the alpha or beta version won't be valid any more.

alpha | beta | GA | gax | gax-grpc
------------- | ------------ | ---------- | ---------- | --------
0.30.0-alpha | 0.30.0-beta | 1.12.0 | 1.15.0 | 1.15.0
0.29.0-alpha | 0.29.0-beta | 1.11.0 | 1.15.0 | 1.15.0
0.28.0-alpha | 0.28.0-beta | 1.10.0 | 1.14.0 | 1.14.0
0.27.0-alpha | 0.27.0-beta | 1.9.0 | 1.13.0 | 0.30.0
0.26.0-alpha | 0.26.0-beta | 1.8.0 | 1.9.0 | 0.26.0
0.25.0-alpha | 0.25.0-beta | 1.7.0 | 1.8.1 | 0.25.1
0.24.0-alpha | 0.24.0-beta | 1.6.0 | 1.8.1 | 0.25.1
0.23.1-alpha | 0.23.1-beta | 1.5.1 | 1.8.1 | 0.25.1
0.23.0-alpha | 0.23.0-beta | 1.5.0 | 1.5.0 | 0.22.0
0.22.0-alpha | 0.22.0-beta | 1.4.0 | 1.5.0 | 0.22.0
0.21.1-alpha | 0.21.1-beta | 1.3.1 | 1.5.0 | 0.22.0
0.21.0-alpha | 0.21.0-beta | 1.3.0 | 1.5.0 | 0.22.0
0.20.3-alpha | 0.20.3-beta | 1.2.3 | 1.4.2 | 0.21.2
0.20.2-alpha | 0.20.2-beta | 1.2.2 | 1.4.2 | 0.21.2
0.20.1-alpha | 0.20.1-beta | 1.2.1 | 1.4.1 | 0.21.1
0.20.0-alpha | 0.20.0-beta | 1.2.0 | 1.3.1 | 0.20.0
0.19.0-alpha | 0.19.0-beta | 1.1.0 | 1.3.0 | 0.19.0
0.18.0-alpha | 0.18.0-beta | 1.0.2 | 1.1.0 | 0.17.0
0.17.2-alpha | 0.17.2-beta | 1.0.1 | 1.0.0 | 0.16.0
0.17.1-alpha | 0.17.1-beta | 1.0.0 | 1.0.0 | 0.16.0
0.17.0-alpha | 0.17.0-beta | 1.0.0-rc4 | 1.0.0-rc1 | 0.15.0

Contributing
------------

Expand Down