|
|
@@ -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
|
Jisi Liu