Commit Graph

208 Commits

Author SHA1 Message Date
Zhaonian Luan b466d8d380 README.md: Updated compile to implementation. (#5914) 2019-06-21 14:28:54 -07:00
Eric Anderson 5a4178a74e Update README to reference 1.21.0 2019-05-23 13:31:25 -07:00
Kun Zhang 79c286efe9
Update README to reference 1.20.0 (#5577) 2019-04-10 12:49:02 -07:00
ZHANG Dapeng 755a22790b
android/android-interop-testing/examples: upgrade android plugin
This resolves #5523

While bumping `com.android.tools.build:gradle:3.1.2` to `3.3.0`, some other plugins/artifacts/maven repo/buildscripts have to be updated:

- gradle (wrapper) need to upgrade to 4.10.x
- protobuf gradle plugin need to bump a version compatible with gradle version.
- need add `google()` and `jcenter()` repos for android (otherwise `com.android.tools.build:aapt2:3.3.0x` and `trove4j` will not be found resp.)
- need to accept license for Android "build-tools;28.0.3" in kokoro env.
2019-04-02 14:52:27 -07:00
Nguyen Quang Huy 05d5e4802a doc: Change http to https for security links
For security, we should change http into https links.

Co-Authored-By: Nguyen Van Trung [trungnvfet@outlook.com](mailto:trungnvfet@outlook.com)
Signed-off-by: Nguyen Quang Huy [huynq0911@gmail.com](mailto:huynq0911@gmail.com)
2019-02-27 17:25:42 -08:00
Carl Mastrangelo b86fdfa12e
all: update README to reference 1.19.0 2019-02-27 14:55:09 -08:00
ZHANG Dapeng f17a7c0faf
Update README to reference 1.18.0 2019-01-15 10:54:22 -08:00
Jihun Cho 8ccc9899c9 Update README to reference 1.17.1 2018-12-10 10:28:36 -08:00
Jihun Cho c0d4e022f4 Update README to reference 1.17.0 2018-12-05 10:03:43 -08:00
Eric Anderson 7dfde55121 Update README to reference 1.16.1 2018-10-29 10:03:53 -07:00
Eric Anderson 2c9bdd1cda Update README to reference 1.15.1 2018-10-03 08:58:14 -07:00
Kun Zhang 337b78cd34
Update README to reference 1.15.0 (#4847) 2018-09-11 15:01:48 -07:00
Kun Zhang f8274c4e7c
doc: update README because we have been requiring Java 7. (#4819) 2018-09-04 11:09:09 -07:00
Eric Anderson bc05b540f4 README.md: Link to Alpine's protoc-gen-grpc-java 2018-08-24 09:54:39 -07:00
Carl Mastrangelo 30672635de
all: point readme to new jar URL 2018-08-14 14:41:39 -07:00
Eric Anderson 631e46c3e3
README.md: Reorganize and trim
Reorganize the README to flow better for new users, pointing them in
good directions. Also try to reduce the size so they actually read the
thing. It's still to long, but is a step in the right direction.

Fixes #4615
2018-08-14 08:02:22 -07:00
Eric Anderson c42d5bbf2c Bump protobuf-gradle-plugin to 0.8.5
The version bump happened in some places already, but many references
were missed.

This fixes the following warning that shows up with newer versions of
Gradle:
> Using TaskInputs.file() with something that doesn't resolve to a File
> object has been deprecated and is scheduled to be removed in Gradle
> 5.0. Use TaskInputs.files() instead.
2018-08-03 11:41:38 -07:00
Eric Anderson b64cde1488 Encourage using grpc-netty-shaded instead of grpc-netty
grpc-netty is still really useful, but for most users who aren't doing
anything advanced using grpc-netty-shaded is much safer from a
dependency basis.

grpc-netty-shaded has seen more usage and has shown itself to be stable
and reduce the number of conflicts due to Netty versions.
2018-08-02 16:58:59 -07:00
Carl Mastrangelo 128f54ca1c
all: update readme to point to 1.14 2018-07-31 12:19:20 -07:00
Erik Pettersson e520f46984 all: doc(readme) bump versions
Update versions from 1.13.1 to 1.13.2.
2018-07-30 12:51:49 -07:00
ZHANG Dapeng e59aac7178
Update README to reference 1.13.1 (#4580) 2018-06-21 09:28:30 -07:00
Théo Gaillard 5c4f2c7c0f README.md: update grpc 1.11.0 to 1.12.0 (#4488)
Update version strings.
2018-05-22 20:38:21 -07:00
Eric Gribkoff 785ac4772e
README.md: clarify that Android is for client-side use (#4408) 2018-04-30 10:28:41 -07:00
Jorg Heymans 2094bb4d8e doc: upgrade protobuf-maven-plugin in README.md 2018-04-03 16:51:56 -07:00
Eric Anderson 2a95e38257 Update README to reference 1.11.0 2018-03-29 11:24:06 -07:00
Shohei Kamimori 5af2515f3e core,README: add docs about grpc-java-api-checker (#4182) 2018-03-28 15:34:18 -07:00
Eric Gribkoff 6160727274
README.md: fix maven central link (#4256) 2018-03-22 16:22:18 -07:00
Eric Gribkoff 0c27e719ae
Update README to reference 1.10.0 (#4090) 2018-02-15 18:54:38 -08:00
Eric Gribkoff b940084c33
README.md: include supported Android API levels 2018-01-17 10:18:33 -08:00
Eric Anderson 71bad37402 Update protobuf-gradle-plugin to 0.8.3
This fixes support for newer Android Gradle Plugins.
2018-01-12 08:34:05 -08:00
Kun Zhang 4115491a24
Update README to reference 1.9.0 (#3934) 2018-01-09 13:28:54 -08:00
Kun Zhang 86d64122e5
Upgrade to Protobuf 3.5.1 and Protoc 3.5.1-1. (#3921)
protoc-3.5.0-linux-x86_64 introduced GLIBC_2.14 dependency and broke
gRPC release process (https://github.com/google/protobuf/issues/4138).
3.5.1-1 is the proper re-build.
2018-01-05 16:40:20 -08:00
Carl Mastrangelo aee5fc4176
all: update to proto 3.5.0 2017-11-30 11:50:19 -08:00
Carl Mastrangelo 7d1aae155f
Update README to reference 1.8.0 2017-11-28 14:28:35 -08:00
dapengzhang0 21be70dbe3 Update README to reference 1.7.0 2017-10-11 21:31:49 -07:00
zpencer b579528c89 Update README to reference 1.6.1 (#3428) 2017-08-31 15:24:33 -07:00
Carl Mastrangelo 2175004363 all: recommend latest os maven detector 2017-07-18 10:44:37 -07:00
Carl Mastrangelo d34260a814 all: update to proto gradle plugin 0.8.1 2017-07-14 12:35:14 -07:00
Mehrdad Afshari 8ce0bc25b6 Canonicalize URL prefixes to https://grpc.io 2017-07-10 16:30:09 -07:00
Carl Mastrangelo d6d3a53d25 all: update readme to point to 1.4.0 2017-06-16 15:03:14 -07:00
Carl Mastrangelo 8dc29f91bb all: bump recommended gRPC and Proto to 1.3.0 and 3.2.0 2017-04-28 13:36:21 -07:00
Carl Mastrangelo caa0dd23aa all: bump recommended version to 1.2.0 2017-03-17 14:54:45 -07:00
Carl Mastrangelo 218bc03aeb all: recommend the latest gRPC version on master 2017-02-23 16:09:42 -08:00
Kun Zhang d0d2c1e796 docs: add links to examples and tutorials. (#2614) 2017-01-18 09:06:45 -08:00
Eric Anderson de10b94128 readme: Downgrade protoc to 3.0.2 to match grpc-protobuf
Protobuf runtime 3.0.2 is included transitively via grpc-protobuf
v1.0.3. Protoc doesn't have to match the version identically, but must
not be newer than the runtime. We must wait until v1.1 release of grpc
to bump protobuf version in the readme.

Fixes #2578
2017-01-10 11:09:49 -08:00
Eric Anderson 04f216f072 Update README to reference 1.0.3 2016-12-29 12:11:07 -06:00
Eric Anderson 67ff170b96 docs: Place all badges together 2016-12-06 16:45:00 -08:00
Kailash Sethuraman a10261af48 all: add gitter chat icon to the README.md file 2016-12-05 15:12:36 -08:00
Eric Anderson 06697b5376 doc: link to IDE-specific docs for os-maven-plugin 2016-11-15 22:34:50 -08:00
Eric Anderson c38611a230 Bump protobuf to 3.1.0
Also removed warnings about protoc version matching runtime, since this
is no longer supposed to be a problem (starting with 3.0.0-beta-4) and
all our tests ran fine when using protoc 3.0.2 with protobuf runtime
3.1.0.

Fixes #2316
2016-11-01 14:52:56 -07:00
Eric Anderson 28ba5995de Update README to reference 1.0.1 2016-09-29 20:21:29 -07:00
Eric Anderson b1d72e5c3e all: Bump protobuf to 3.0.2, to fix protoc in CI
protoc no longer builds in 3.0.0 because auto-download of the gmock zip
now fails. 3.0.2 has a fix to autogen:
bba446bbf2

All that was strictly necessary was to update .travis.yml and
buildscripts/, but it helps our sanity to keep the rest of the protobuf
versions in sync. Lite is left on its existing version, because it did
not see a bump of neither the java library nor the protoc plugin.
2016-09-29 10:25:31 -07:00
Eric Anderson 57b9dd467f Update README to reference 1.0.0 2016-08-19 09:45:34 -07:00
Kun Zhang 9d747bbbcd build: upgrade to protobuf-gradle-plugin 0.8.0 2016-08-18 13:06:18 -07:00
Eric Anderson aa33c59f0d Slightly encourage more use of lite, instead of nano
This is basically a continuation of 4b17a2e31
2016-07-29 12:39:50 -07:00
Sky Ao 841c7c4bfa docs: update grpc version to 0.15.0 and protoc to 3.0.0-beta-3 2016-07-25 09:58:43 -07:00
Eric Anderson a62e976229 docs: Don't suggest using grpc-all
Using grpc-all pulls in more dependencies than necessary, as virtually
no user needs both OkHttp and Netty or both Protobuf and Protobuf Nano.
When the separate deps are listed, users are much more likely to remove
unnecessary deps.

Fixes #1597
2016-06-14 10:58:38 -07:00
Eric Anderson 4e8cf923ca docs: Don't suggest downloading grpc-all
grpc-all is now just a husk of a JAR. Instead, users will need to
download each JAR they need separately.

Fixes #1805
2016-05-12 13:00:47 -07:00
Eric Anderson 446f0cb85f Upgrade to Gradle 2.13
This improves our documentation for the gradle protobuf plugin, as its
version is dependent on the gradle version.

Gradle now has the --tests flag, performance improvements, and support
for OpenPGP subkeys.
2016-05-09 09:36:13 -07:00
Carl Mastrangelo b4fc929614 all: Update Readme to reflect latest release (0.14.0) 2016-05-02 15:07:45 -07:00
Eric Anderson 397d8618a1 Update README to reference v0.13.2 2016-03-10 16:15:03 -08:00
Eric Anderson 340481859f Update README to reference 0.13.1 2016-02-23 08:38:48 -08:00
Eric Anderson 85e68dbe98 Update README to reference 0.13.0 2016-02-18 16:34:23 -08:00
Eric Anderson 41c3f78687 Maven protoc plugin has a new name and is on Maven Central 2016-02-16 15:29:24 -08:00
Eric Anderson e61e6c27ad Update README to point to protobuf-gradle-plugin 0.7.4
We've been using 0.7.0 since 5df6ab0 and 0.7.4 since d3d253e, but hadn't
updated the README. 0.6.1 wouldn't work in Java 7, so using a newer
version can prevent users from hitting that bump.
2016-02-04 09:49:50 -08:00
Eric Anderson 5b726ac0b3 Update README to reference 0.12.0
The version of protoc to use was bumped prematurely in e2ed2e8, so it is
reverted back to beta-1 here. When 0.13.0 is released then the protoc
version should be bumped.
2016-02-03 14:20:39 -08:00
Kun Zhang e2ed2e8f03 Upgrade to protobuf-3.0.0-beta-2 and protobuf-nano-3.0.0-alpha-5
Update option name that disables protobuf tests.
2016-01-27 23:32:01 -08:00
Eric Anderson 52f17055a4 Document where to put proto files when using build plugins 2016-01-27 10:43:42 -08:00
Xudong Ma 996ea2fc22 Give dependency example for android clients. 2015-10-07 16:08:36 -07:00
Eric Anderson 9ea70ad29c Update README to reference 0.9.0 2015-09-29 17:57:33 -07:00
nmittler b7a72c1618 Adding homepage and mailing list to the README 2015-09-24 12:32:45 -07:00
Artem Prigoda 24c398ed1c Upgrade maven-os-plugin in README
Upgrade `os-maven-plugin` to 1.4.0, which fixes a bug with
running in Intellij IDEA with a bundled Maven version (3.0.5).

See https://github.com/trustin/os-maven-plugin/issues/5
2015-09-16 22:52:26 +03:00
Eric Anderson 1b1c646ccd Split compiling instructions out of README.md
The compilation instructions are long and scary, and they distract from
other documentation in the README. Most users don't need them, so by
moving the instructions out we improve the ease of use of the document.
2015-08-14 09:15:34 -07:00
Carl Mastrangelo 3c924fda85 Update README to use latest version 2015-08-13 16:27:58 -07:00
Kun Zhang e1bd6ef45f Clean up the left-over of the transport package reorganization 2015-08-11 12:48:02 -07:00
Eric Anderson 66ce0f2060 Add code coverage badge to README.md
Moving to below the header reduces the amount of whitespace between them
and the rest of the text.
2015-08-11 12:25:17 -07:00
mekka 9990794b40 Documentation hygiene. Fixing some minor typos in the README file. 2015-08-07 23:28:06 -07:00
Kun Zhang fc85a4085a Add more documentation for transports.
- Add package descriptions for transport, netty and okhttp.
- Describe transports (netty, okhttp and inprocess) in README
2015-08-06 17:24:42 -07:00
Kun Zhang 137b2ef8c3 Upgrade protobuf-gradle-plugin to 0.6.1 2015-08-03 13:41:48 -07:00
Kun Zhang 8bd8ed879f Fix protobuf plugin usage in README.md
- The version of protoc should be the same as the version of
  protobuf-java that is transitively depended by grpc
- Updated protobuf-gradle-plugin example to use version 0.5.0
2015-07-22 15:25:12 -07:00
Ben McCann 652abe2f63 Simplify the build instructions now that Netty can be fetched from Maven 2015-07-09 15:29:11 -07:00
Kun Zhang af9fb6de77 Migrate from PARSER to parser() as a way of getting the parser of a protobuf message.
Upgrade to protobuf-3.0.0-alpha-3.1 that adds parser(). PARSER will go away eventually.
2015-06-30 23:14:21 -07:00
Kun Zhang 7a71627e86 Add the bintray repository for Maven protoc-plugin in the example 2015-06-30 23:11:41 -07:00
nmittler d94fedc854 Updating master README.md to 0.7.1 release. 2015-06-12 07:32:50 -07:00
Kun Zhang a251171850 Upgrade to protobuf-3.0.0-alpha-3 2015-06-05 16:27:17 -07:00
Kun Zhang 2ee4d0228d Rename Call to ClientCalls.
Other classes are already following the convention that ClientFoo for
client-side, and ServerFoo for server-side. Call has been the black
sheep of the family.

- Call -> ClientCall
- Calls -> ClientCalls
- ForwardingCall* -> ForwardingClientCall*
2015-06-04 16:39:25 -07:00
nmittler 2483009fe3 Renaming AUTH_README.md to SECURITY.md
The doc discusses TLS as well as auth, so "AUTH" doesn't seem quite right.
2015-05-28 14:01:44 -07:00
Eric Anderson 1eb16d94fc Add download and usage instructions 2015-05-27 13:04:15 -07:00
Eric Anderson e03d5c0210 Rename integration-testing to interop-testing
"Interoperability" is a more appropriate name for the tests, since they
are used for testing across different implementations. They will do a
bit of integration testing, like for auth, but this is a smaller scale.

It seems the other languages (Go, C++, Node, PHP, Python, Ruby) are
using "interop" to describe the tests, and the test case specifications
document is named with "interop". After this change, C# will be the only
language calling them "integration" tests.

This change just renames the folder and artifact. We can change the
internal package names later. However, once we do a release, old
artifact names will live forever in Maven Central.
2015-05-20 14:57:36 -07:00
Eric Anderson 65291321d8 Make it more obvious JDK 8 is commonly necessary
Resolves #427
2015-05-15 12:07:28 -07:00
Kun Zhang 9805e27569 Add property ``protoc=/path/to/protoc``
This allows people who cannot run the pre-compiled ``protoc`` pulled
from Maven Central to use their own ``protoc``.

Upgrade to protobuf-gradle-plugin:0.4.1 to display error messages of
protoc failures.
2015-05-12 17:34:40 -07:00
Eric Anderson 66c55ee2b6 Make protobuf section of README easily ignorable 2015-05-07 15:52:29 -07:00
Kun Zhang 2f7497133d Unify build properties.
- Switch all system properties to project properties.
- Use the ``javaLocalNamingStyle`` instead of the
  ``dot.delimited.style`` for property names, so that it can be directly
  referenced by ``rootProject.propertyName``.
- Recommend users to put GRPC-specific properties in project-level
  ``build.properties`` instead of the user-level.
2015-05-07 14:14:10 -07:00
Kun Zhang d32bb477b9 Add build status icon and rephrase title 2015-05-06 16:15:53 -07:00
Kun Zhang 111f6dd81e Allow people to skip codegen compilation.
Resolves #357

- Add project property ``grpc.skip.codegen``, which is false by default.
  People who don't change the codegen nor the proto files can set it to
  true so that they don't need to set up C++ compilation.
- Check in all generated files under ``src/generated``.
2015-05-06 09:56:40 -07:00
Kun Zhang 221c534f11 Fix build on Windows/VC++
- Stop defining custom architectures because VisualCpp toolchain doesn't
  allow it. Reference to built-in architectures 'x86' and 'x86_64' since
  they are supported by all toolchains.
- Remove 'local_arch' from platforms. For unsupported platform, we just
  do not specify the target.
- Target no more than one platform at a time. This simplifies the build
  script a lot.
- Remove the TARGET_ARCHS environment variable. Add system property
  ``arch`` to override ``osdetector.arch``.
- Add ``vc.disable`` to override the default choice of VisualCpp on
  Windows.
- Add ``vc.`` prefix to the properties that are only used with VC++
2015-05-04 09:25:49 -07:00
Kun Zhang fd0aed22ce Reorganize build instructions.
- Use headers for instructions for different systems.
- Mention that on OSX 10.10 extra environment variables are needed to
  search in '/usr/local'.
2015-04-30 17:34:02 -07:00
Kun Zhang a8ef36af16 Create DEPLOYING.md that documents instructions for deploying artifacts.
Move deployment instructions of compiler/README.md there too.
2015-04-23 13:49:26 -07:00
Eric Anderson 2f3c173179 Protobuf java/nano are now on Maven Central 2015-03-20 14:50:10 -07:00
Jakob Buchgraber c56cec7d92 Update README.md to Netty 4.1 2015-03-11 14:30:08 -07:00
Eric Anderson 456216b364 Add some details for building on Windows.
More will be necessary, as we don't describe how to build protobuf
itself, but this should be a clear improvement.
2015-03-03 22:49:19 -08:00
Eric Anderson a6f5fff6e4 Depend on proto 3.0.0-alpha-2 instead of snapshot
There has now been a release of the proto code we need, so use it
instead of master.
2015-02-26 07:56:13 -08:00
rocking c60f0171cb Open source nano proto related code
-------------
Created by MOE: http://code.google.com/p/moe-java
MOE_MIGRATED_REVID=87180572
2015-02-25 15:36:20 -08:00
Eric Anderson b10aaf8c77 Inform users they need Maven 3.2 to build our deps 2015-02-19 13:14:00 -08:00
Louis Ryan 65d64cd934 Add more detailed instructions for enabling protoc when built from repo 2015-02-18 14:51:42 -08:00
Eric Anderson fb28ad235b Improve Gradle build of protoc grpc plugin
A Gradle protoc plugin is used for generating and compiling the grpc
codegen. The code organization was changed to match what Gradle expects.

Proto 3 is now required.
2015-01-30 10:19:32 -08:00
nmittler f83145865a Removing all references to "stubby" 2015-01-27 11:25:25 -08:00
ejona d4531dae1c Add README
-------------
Created by MOE: http://code.google.com/p/moe-java
MOE_MIGRATED_REVID=82154383
2015-01-08 14:43:21 -08:00