VertexAI - Change packaging logic to use a source library (#1196)

* VertexAI - Change logic to use a source library

* Mark internal methods with comments

* Update ModelContent.cs

* Update build_testapps.json

* Update comments

* More comments

Author: a-maurice

scripts/gha/integration_testing/build_testapps.json

@@ -214,6 +214,23 @@
         "com.google.firebase.auth-*.tgz",
         "com.google.firebase.storage-*.tgz"
       ]
+    },
+    {
+      "name": "vertexai",
+      "full_name": "FirebaseVertexAI",
+      "captial_name": "VertexAI",
+      "bundle_id": "com.google.firebase.unity.vertexai.testapp",
+      "testapp_path": "vertexai/testapp",
+      "platforms": ["Android", "Playmode", "iOS", "tvOS", "Windows", "macOS", "Linux"],
+      "plugins": [
+        "FirebaseVertexAI.unitypackage"
+      ],
+      "provision": "Firebase_Dev_Wildcard.mobileprovision",
+      "upm_packages": [
+        "com.google.external-dependency-manager-*.tgz",
+        "com.google.firebase.app-*.tgz",
+        "com.google.firebase.vertexai-*.tgz"
+      ]
     }
   ],
   "skipped_testapp_files": [

unity_packer/debug_single_export_json/vertexai.json

@@ -215,18 +215,9 @@
       "name": "FirebaseVertexAI.unitypackage",
       "imports": [
         {
-          "importer": "PluginImporter",
-          "platforms": [
-            "Editor",
-            "Standalone",
-            "Android",
-            "iOS",
-            "tvOS"
-          ],
-          "cpu": "AnyCPU",
+          "importer": "DefaultImporter",
           "paths": [
-            "Firebase/Plugins/Firebase.VertexAI.dll",
-            "Firebase/Plugins/Firebase.VertexAI.pdb"
+            "Firebase/VertexAI/*"
           ]
         },
         {

vertexai/CMakeLists.txt

@@ -14,41 +14,19 @@
 
 # CMake file for the Vertex AI in Firebase library
 
-# Vertex AI in Firebase CSharp files
-set(firebase_vertexai_src
-  src/Candidate.cs
-  src/Chat.cs
-  src/Citation.cs
-  src/CountTokensResponse.cs
-  src/FunctionCalling.cs
-  src/GenerateContentResponse.cs
-  src/GenerationConfig.cs
-  src/GenerativeModel.cs
-  src/ModelContent.cs
-  src/RequestOptions.cs
-  src/Safety.cs
-  src/Schema.cs
-  src/VertexAI.cs
-  src/VertexAIException.cs
+# Vertex AI in Firebase is different from the other Firebase libraries,
+# as instead of prebuilding, we provide it as a source library.
+
+# Package every file under src, including subfolders, since we want them all.
+unity_pack_folder(
+  "${FIREBASE_UNITY_DIR}/vertexai/src/"
+  PACK_PATH "Firebase/VertexAI"
 )
 
+# For documentation, get only the C# files at the top level,
+# which make up the public API.
+file(GLOB firebase_vertexai_doc_src "src/*.cs")
 unity_pack_documentation_sources(vertexai
   DOCUMENTATION_SOURCES
     ${firebase_vertexai_src}
 )
-
-mono_add_library(firebase_vertexai
-  MODULE
-    Firebase.VertexAI
-  SOURCES
-    ${firebase_vertexai_src}
-  REFERENCES
-    ${FIREBASE_PLATFORM_REF}
-)
-
-unity_pack_cs(firebase_vertexai)
-
-set_property(TARGET firebase_vertexai
-  PROPERTY FOLDER
-  "Firebase ${FIREBASE_PLATFORM_NAME}"
-)

vertexai/src/Candidate.cs

@@ -121,6 +121,10 @@ private static FinishReason ParseFinishReason(string str) {
     };
   }
 
+  /// <summary>
+  /// Intended for internal use only.
+  /// This method is used for deserializing JSON responses and should not be called directly.
+  /// </summary>
   internal static Candidate FromJson(Dictionary<string, object> jsonDict) {
     return new Candidate(
       jsonDict.ParseObject("content", ModelContent.FromJson, defaultValue: new ModelContent("model")),

vertexai/src/Candidate.cs.meta

@@ -38,6 +38,10 @@ private CitationMetadata(List<Citation> citations) {
     _citations = new ReadOnlyCollection<Citation>(citations ?? new List<Citation>());
   }
 
+  /// <summary>
+  /// Intended for internal use only.
+  /// This method is used for deserializing JSON responses and should not be called directly.
+  /// </summary>
   internal static CitationMetadata FromJson(Dictionary<string, object> jsonDict) {
     return new CitationMetadata(
       jsonDict.ParseObjectList("citations", Citation.FromJson));
@@ -84,6 +88,10 @@ private Citation(int startIndex, int endIndex, Uri uri, string title,
     PublicationDate = publicationDate;
   }
 
+  /// <summary>
+  /// Intended for internal use only.
+  /// This method is used for deserializing JSON responses and should not be called directly.
+  /// </summary>
   internal static Citation FromJson(Dictionary<string, object> jsonDict) {
     // If there is a Uri, need to convert it.
     Uri uri = null;