Skip to content
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

Jump to bottom

Move BOM info to right after Quick Start #3555

Merged
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
100 changes: 59 additions & 41 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -84,12 +84,7 @@ Besides adding client libraries, the plugins provide additional functionality, s

These client libraries can be used on App Engine standard for Java 8 runtime and App Engine flexible (including the Compat runtime). Most of the libraries do not work on the App Engine standard for Java 7 runtime. However, Datastore, Storage, and Bigquery should work.

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:
If you are running into problems with version conflicts, the easiest way to solve the 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
Expand All @@ -107,41 +102,7 @@ The easiest way to solve version conflicts is to use google-cloud's BOM. In Mave
```
[//]: # ({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
For more details about how to use BOM, see [Version Management](#version-management).

Specifying a Project ID
-----------------------
Expand Down Expand Up @@ -337,6 +298,63 @@ 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 comment was marked as spam.

Sign in to view


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