diff options
author | Jisi Liu <liujisi@google.com> | 2016-07-27 14:40:30 -0700 |
---|---|---|
committer | GitHub <noreply@github.com> | 2016-07-27 14:40:30 -0700 |
commit | e8ae137c96444ea313485ed1118c5e43b2099cf1 (patch) | |
tree | a9450765d44a15ddea6b396721c63a6e79732eb5 /CHANGES.txt | |
parent | 7ba044a1c051c61066648b2b4fc80bbbcbe2c79b (diff) | |
parent | e0d817e0dec88e4b9f415db7f51b38e1e0ee55bb (diff) | |
download | protobuf-e8ae137c96444ea313485ed1118c5e43b2099cf1.tar.gz protobuf-e8ae137c96444ea313485ed1118c5e43b2099cf1.tar.bz2 protobuf-e8ae137c96444ea313485ed1118c5e43b2099cf1.zip |
Merge pull request #1864 from pherl/galogsv3.0.0
Change log for 3.0 GA release.
Diffstat (limited to 'CHANGES.txt')
-rw-r--r-- | CHANGES.txt | 51 |
1 files changed, 51 insertions, 0 deletions
diff --git a/CHANGES.txt b/CHANGES.txt index 04fa418e..822136c0 100644 --- a/CHANGES.txt +++ b/CHANGES.txt @@ -1,3 +1,54 @@ +2016-07-27 version 3.0.0 (C++/Java/Python/Ruby/Objective-C/C#/JavaScript/Lite) + General + * This log only contains changes since the beta-4 release. Summarized change + log since the last stable release (v2.6.1) can be found in the github + release page. + + Compatibility Notice + * v3.0.0 is the first API stable release of the v3.x series. We do not expect + any future API breaking changes. + * For C++, Java Lite and Objective-C, source level compatibility is + guaranteed. Upgrading from v3.0.0 to newer minor version releases will be + source compatible. For example, if your code compiles against protobuf + v3.0.0, it will continue to compile after you upgrade protobuf library to + v3.1.0. + * For other languages, both source level compatibility and binary level + compatibility are guaranteed. For example, if you have a Java binary built + against protobuf v3.0.0. After switching the protobuf runtime binary to + v3.1.0, your built binary should continue to work. + * Compatibility is only guaranteed for documented API and documented + behaviors. If you are using undocumented API (e.g., use anything in the C++ + internal namespace), it can be broken by minor version releases in an + undetermined manner. + + Ruby + * When you assign a string field `a.string_field = "X"`, we now call + #encode(UTF-8) on the string and freeze the copy. This saves you from + needing to ensure the string is already encoded as UTF-8. It also prevents + you from mutating the string after it has been assigned (this is how we + ensure it stays valid UTF-8). + * The generated file for `foo.proto` is now `foo_pb.rb` instead of just + `foo.rb`. This makes it easier to see which imports/requires are from + protobuf generated code, and also prevents conflicts with any `foo.rb` file + you might have written directly in Ruby. It is a backward-incompatible + change: you will need to update all of your `require` statements. + * For package names like `foo_bar`, we now translate this to the Ruby module + `FooBar`. This is more idiomatic Ruby than what we used to do (`Foo_bar`). + + JavaScript + * Scalar fields like numbers and boolean now return defaults instead of + `undefined` or `null` when they are unset. You can test for presence + explicitly by calling `hasFoo()`, which we now generate for scalar fields. + + Java Lite + * Java Lite is now implemented as a separate plugin, maintained in the + `javalite` branch. Both lite runtime and protoc artifacts will be available + in Maven. + + C# + * Target platforms now .NET 4.5, selected portable subsets and .NET Core. + * legacy_enum_values option is no longer supported. + 2016-07-15 version 3.0.0-beta-4 (C++/Java/Python/Ruby/Objective-C/C#/JavaScript) General * Added a deterministic serialization API for C++. The deterministic |