Upgrade GAE Java version from 3.0.3 to 4.0.0 and prepare next version 4.0.1-SNAPSHOT

PiperOrigin-RevId: 850486188
Change-Id: I4d0788b1fc17e038b54068243c42146a13193205

Author: ludoch

README.md

@@ -74,7 +74,7 @@ The packages `com.google.appengine.api.blobstore.ee10` and `com.google.appengine
         <dependency>
             <groupId>com.google.appengine</groupId>
             <artifactId>appengine-api-1.0-sdk</artifactId>
-            <version>3.0.3</version><!-- or later-->
+            <version>4.0.0</version><!-- or later-->
         </dependency>
         <dependency>
           <groupId>javax.servlet</groupId>
@@ -94,7 +94,7 @@ The packages `com.google.appengine.api.blobstore.ee10` and `com.google.appengine
         <dependency>
             <groupId>com.google.appengine</groupId>
             <artifactId>appengine-api-1.0-sdk</artifactId>
-            <version>3.0.3</version><!-- or later-->
+            <version>4.0.0</version><!-- or later-->
         </dependency>
         <dependency>
           <groupId>jakarta.servlet</groupId>
@@ -105,7 +105,7 @@ The packages `com.google.appengine.api.blobstore.ee10` and `com.google.appengine
     ...
     ```
 
-*  Maven Java 25 Alpha with jakarta EE 11 support pom.xml (EE10 is not supported in Java25, EE11 is fully compatible with EE10)
+*  Maven Java 25 with jakarta EE 11 support pom.xml (EE10 is not supported in Java25, EE11 is fully compatible with EE10)
 
     ```
     <packaging>war</packaging><!-- Servlet 6.1 WAR packaging-->
@@ -114,7 +114,7 @@ The packages `com.google.appengine.api.blobstore.ee10` and `com.google.appengine
         <dependency>
             <groupId>com.google.appengine</groupId>
             <artifactId>appengine-api-1.0-sdk</artifactId>
-            <version>3.0.3</version><!-- or later-->
+            <version>4.0.0</version><!-- or later-->
         </dependency>
         <dependency>
           <groupId>jakarta.servlet</groupId>
@@ -131,7 +131,7 @@ The packages `com.google.appengine.api.blobstore.ee10` and `com.google.appengine
     ```
     <?xml version="1.0" encoding="utf-8"?>
     <appengine-web-app xmlns="http://appengine.google.com/ns/1.0">
-      <runtime>java21</runtime> <-- or java25 alpha-->
+      <runtime>java25</runtime> <-- or java21-->
       <app-engine-apis>true</app-engine-apis>
 
       <!-- Add optionally:
@@ -156,7 +156,7 @@ The packages `com.google.appengine.api.blobstore.ee10` and `com.google.appengine
     </appengine-web-app>
     ```
 
-*  Java 21  appengine-web.xml (will default to EE10, but EE8 possible)
+*  Java 21 appengine-web.xml (will default to EE10, but EE8 possible)
 
     ```
     <?xml version="1.0" encoding="utf-8"?>
@@ -166,8 +166,7 @@ The packages `com.google.appengine.api.blobstore.ee10` and `com.google.appengine
     </appengine-web-app>
     ```
 
-
-*  Java 25  appengine-web.xml (will default to EE11, but EE8 possible) Alpha
+*  Java 25 appengine-web.xml (will default to EE11, but EE8 possible)
 
     ```
     <?xml version="1.0" encoding="utf-8"?>
@@ -224,14 +223,14 @@ Source code for remote APIs for App Engine.
     <dependency>
        <groupId>com.google.appengine</groupId>
        <artifactId>appengine-remote-api</artifactId>
-       <version>3.0.3</version><!-- or later-->
+       <version>4.0.0</version><!-- or later-->
     </dependency>
 ```
 
 #### User Visible Changes With Maven Builds
 
 We moved `com.google.appengine.api.memcache.stdimpl` and its old dependency
-`javax.cache` from `appengine-api-1.0-sdk.jar` to  a new jar `appengine-api-legacy.jar`.
+`javax.cache` from `appengine-api-1.0-sdk.jar` to a new jar `appengine-api-legacy.jar`.
 
 - [Latest javadoc.io Javadocs from this repository](https://javadoc.io/doc/com.google.appengine/appengine-api-legacy)
 
@@ -247,7 +246,7 @@ We moved `com.google.appengine.api.memcache.stdimpl` and its old dependency
     <dependency>
        <groupId>com.google.appengine</groupId>
        <artifactId>appengine-api-legacy.jar/artifactId>
-       <version>3.0.3</version><!-- Or later-->
+       <version>4.0.0</version><!-- Or later-->
     </dependency>
 ```
 
@@ -262,19 +261,19 @@ We moved `com.google.appengine.api.memcache.stdimpl` and its old dependency
     <dependency>
       <groupId>com.google.appengine</groupId>
       <artifactId>appengine-testing</artifactId>
-      <version>3.0.3</version><!-- or later-->
+      <version>4.0.0</version><!-- or later-->
       <scope>test</scope>
     </dependency>
     <dependency>
       <groupId>com.google.appengine</groupId>
       <artifactId>appengine-api-stubs</artifactId>
-      <version>3.0.3</version><!-- or later-->
+      <version>4.0.0</version><!-- or later-->
       <scope>test</scope>
     </dependency>
     <dependency>
       <groupId>com.google.appengine</groupId>
       <artifactId>appengine-tools-sdk</artifactId>
-      <version>3.0.3</version><!-- or later-->
+      <version>4.0.0</version><!-- or later-->
       <scope>test</scope>
     </dependency>
 ```

RELEASENOTES.md

@@ -0,0 +1,68 @@
+<!--
+ Copyright 2021 Google LLC
+
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+
+     https://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+
+# Release Notes 4.0.0 December 30 2025.
+
+## Breaking Changes
+
+* Package Renaming for Byte-Safe Protos:
+The core change is the introduction of parallel Java proto libraries. 
+When a .proto file is processed to handle potentially non-UTF8 string fields 
+as bytes, the generated Java code is placed in a new package.
+Typically, the java_package option in the .proto files is modified. 
+For example, com.google.appengine.api.taskqueue becomes com.google.appengine.api.taskqueue_bytes.
+Similarly, com.google.storage.onestore.v3 becomes com.google.storage.onestore.v3_bytes.
+* bytes Instead of string:
+The fundamental goal is to address fields in protos that were declared as 
+string but in practice could contain arbitrary byte arrays, not necessarily valid UTF-8 strings. 
+In Java Proto1, these were often treated as String, 
+which could lead to corruption or exceptions.
+*   The `com.google.appengine.api.datastore` package has been updated to use
+    proto2 versions of Onestore Entity protos. These protos are repackaged
+    (shaded) within this JAR.
+*   The `com.google.appengine.api.datastore.EntityTranslator` class:
+    *   `EntityTranslator.createFromPb(EntityProto)` now accepts
+        `com.google.appengine.repackaged.com.google.storage.onestore.v3_bytes.proto2api.OnestoreEntity.EntityProto`
+        instead of
+        `com.google.storage.onestore.v3.OnestoreEntity.EntityProto`.
+    *   `EntityTranslator.convertToPb(Entity)` now returns
+        `com.google.appengine.repackaged.com.google.storage.onestore.v3_bytes.proto2api.OnestoreEntity.EntityProto`
+        instead of
+        `com.google.storage.onestore.v3.OnestoreEntity.EntityProto`.
+*   The `com.google.appengine.api.datastore.KeyTranslator` class:
+    *   `KeyTranslator.createFromPb(Reference)` now accepts
+        `com.google.appengine.repackaged.com.google.storage.onestore.v3_bytes.proto2api.OnestoreEntity.Reference`
+        instead of
+        `com.google.storage.onestore.v3.OnestoreEntity.Reference`.
+    *   `KeyTranslator.convertToPb(Key)` now returns
+        `com.google.appengine.repackaged.com.google.storage.onestore.v3_bytes.proto2api.OnestoreEntity.Reference`
+        instead of
+        `com.google.storage.onestore.v3.OnestoreEntity.Reference`.
+*   The `com.google.appengine.api.datastore.DataTypeTranslator` class:
+    *   Methods `addPropertiesToPb`, `extractPropertiesFromPb`,
+        `extractIndexedPropertiesFromPb`, `extractImplicitPropertiesFromPb`, and
+        `findIndexedPropertiesOnPb` now accept
+        `com.google.appengine.repackaged.com.google.storage.onestore.v3_bytes.proto2api.OnestoreEntity.EntityProto`
+        instead of
+        `com.google.storage.onestore.v3.OnestoreEntity.EntityProto`.
+    *   Method `getPropertyValue` now accepts
+        `com.google.appengine.repackaged.com.google.storage.onestore.v3_bytes.proto2api.OnestoreEntity.Property`
+        instead of
+        `com.google.storage.onestore.v3.OnestoreEntity.Property`.
+    *   Method `getComparablePropertyValue` now accepts
+        `com.google.appengine.repackaged.com.google.storage.onestore.v3_bytes.proto2api.OnestoreEntity.Property`
+        instead of
+        `com.google.storage.onestore.v3.OnestoreEntity.Property`.

TRYLATESTBITSINPROD.md

@@ -49,7 +49,7 @@ top of your web application and change the entrypoint to boot with these jars in
  ./mvnw clean install
 ```
 
-Let's assume the current build version is `4.0.0-SNAPSHOT`.
+Let's assume the current build version is `4.0.1-SNAPSHOT`.
 
 See the output of the runtime deployment module which contains all the jars needed by the runtime:
 
@@ -70,7 +70,7 @@ Add the dependency for the GAE runtime jars in your application pom.xml file:
 
 ```
  <properties>
-        <appengine.runtime.version>4.0.0-SNAPSHOT</appengine.runtime.version>
+        <appengine.runtime.version>4.0.1-SNAPSHOT</appengine.runtime.version>
         <appengine.runtime.location>target/${project.artifactId}-${project.version}</appengine.runtime.location>
  <properties>
  ...

api/pom.xml

@@ -21,7 +21,7 @@
   <parent>
     <groupId>com.google.appengine</groupId>
     <artifactId>parent</artifactId>
-    <version>4.0.0-SNAPSHOT</version>
+    <version>4.0.1-SNAPSHOT</version>
   </parent>
   <properties>
     <maven.deploy.skip>true</maven.deploy.skip>

api_dev/pom.xml

@@ -23,7 +23,7 @@
   <parent>
     <groupId>com.google.appengine</groupId>
     <artifactId>parent</artifactId>
-    <version>4.0.0-SNAPSHOT</version>
+    <version>4.0.1-SNAPSHOT</version>
   </parent>
 
   <packaging>jar</packaging>

api_legacy/pom.xml

@@ -22,7 +22,7 @@
   <parent>
     <groupId>com.google.appengine</groupId>
     <artifactId>parent</artifactId>
-    <version>4.0.0-SNAPSHOT</version>
+    <version>4.0.1-SNAPSHOT</version>
   </parent>
 
   <packaging>jar</packaging>

appengine-api-1.0-sdk/pom.xml

@@ -20,7 +20,7 @@
   <parent>
     <groupId>com.google.appengine</groupId>
     <artifactId>parent</artifactId>
-    <version>4.0.0-SNAPSHOT</version>
+    <version>4.0.1-SNAPSHOT</version>
   </parent>
   <packaging>jar</packaging>
   <name>AppEngine :: appengine-api-1.0-sdk</name>

appengine-api-stubs/pom.xml

@@ -23,7 +23,7 @@
   <parent>
     <groupId>com.google.appengine</groupId>
     <artifactId>parent</artifactId>
-    <version>4.0.0-SNAPSHOT</version>
+    <version>4.0.1-SNAPSHOT</version>
   </parent>
 
   <packaging>jar</packaging>

appengine_init/pom.xml

@@ -23,7 +23,7 @@
   <parent>
     <groupId>com.google.appengine</groupId>
     <artifactId>parent</artifactId>
-    <version>4.0.0-SNAPSHOT</version>
+    <version>4.0.1-SNAPSHOT</version>
   </parent>
 
   <packaging>jar</packaging>

appengine_jsr107/pom.xml

@@ -26,7 +26,7 @@
     <parent>
         <groupId>com.google.appengine</groupId>
         <artifactId>parent</artifactId>
-        <version>4.0.0-SNAPSHOT</version>
+        <version>4.0.1-SNAPSHOT</version>
     </parent>
 
     <dependencies>