Update DackkaPlugin to use 1.2.0 (#4714)

* Add package-list for androidx

* Fix broken multi-line links

* Remove link to hidden package

* Add imports for redundant groupid packages

* Hide executors from docs

* Hide misc internal classes and variables

* Fix duplicate or broken function references in docs

* Fix typo in Javadocs

* Remove redundant toString

* Remove old firesite transform file

* Added extra util methods

* Left TODO on FirebaseLibraryExtension

* Migrate DackkaPlugin to latest Dackka version

Author: daymxn

.github/workflows/diff-javadoc.yml

@@ -5,14 +5,15 @@ on:
 
 jobs:
   build:
-    runs-on: ubuntu-latest
+    runs-on: macos-latest
     permissions:
       pull-requests: write
     steps:
-      - name: Make Dir
+      - name: Make diff directory
         run: mkdir ~/diff
 
-      - uses: actions/checkout@v3
+      - name: Checkout PR branch
+        uses: actions/checkout@v3
         with:
           fetch-depth: 2
           submodules: true
@@ -24,31 +25,24 @@ jobs:
           distribution: temurin
           cache: gradle
 
-      - name: Changed Modules
-        id: changed-modules
-        run: |
-          git diff --name-only HEAD~1 | xargs printf -- '--changed-git-paths %s\n' | xargs ./gradlew writeChangedProjects --output-file-path=modules.json --only-firebase-sdks
-          echo "run=$(cat modules.json | sed "s/[]\"[]//g" | sed "s/,/\n/g" | xargs printf -- "%s:kotlinDoc ")" >> $GITHUB_OUTPUT
+      - name: Generate docs for PR branch
+        run: ./gradlew kotlindoc
 
-      - name: Build
-        # Certain SDKs won't export docs, make a blank folder to diff if that's the case
-        run: mkdir build && ./gradlew ${{ steps.changed-modules.outputs.run }}
-
-      - name: Move original docs
+      - name: Move branch docs to diff directory
         run: mv build ~/diff/modified
 
-      - uses: actions/checkout@v3
+      - name: Checkout master
+        uses: actions/checkout@v3
         with:
           ref: ${{ github.base_ref }}
 
-      - name: Build
-        # Certain SDKs won't export docs, make a blank folder to diff if that's the case
-        run: mkdir build && ./gradlew ${{ steps.changed-modules.outputs.run }}
+      - name: Generate docs for Master
+        run: ./gradlew kotlindoc
 
-      - name: Move modified docs
+      - name: Move master docs to diff directory
         run: mv build ~/diff/original
 
-      - name: Diff docs
+      - name: Get diff between Master and Branch docs
         run: >
           `# Recursively diff directories, including new files, git style, with 3 lines of context`
           diff -wEburN ~/diff/original ~/diff/modified

appcheck/firebase-appcheck-debug-testing/src/main/java/com/google/firebase/appcheck/debug/testing/DebugAppCheckTestHelper.java

@@ -15,6 +15,7 @@
 package com.google.firebase.appcheck.debug.testing;
 
 import androidx.annotation.NonNull;
+import androidx.test.platform.app.InstrumentationRegistry;
 import com.google.firebase.FirebaseApp;
 import com.google.firebase.appcheck.AppCheckProviderFactory;
 import com.google.firebase.appcheck.FirebaseAppCheck;
@@ -64,8 +65,8 @@
  */
 public final class DebugAppCheckTestHelper {
   /**
-   * Creates a {@link DebugAppCheckTestHelper} instance with a debug secret obtained from {@link
-   * androidx.test.platform.app.InstrumentationRegistry} arguments.
+   * Creates a {@link DebugAppCheckTestHelper} instance with a debug secret obtained from <br>
+   * {@link InstrumentationRegistry} arguments.
    */
   @NonNull
   public static DebugAppCheckTestHelper fromInstrumentationArgs() {

appcheck/firebase-appcheck-debug/src/main/java/com/google/firebase/appcheck/debug/DebugAppCheckProviderFactory.java

@@ -18,10 +18,11 @@
 import com.google.firebase.FirebaseApp;
 import com.google.firebase.appcheck.AppCheckProvider;
 import com.google.firebase.appcheck.AppCheckProviderFactory;
+import com.google.firebase.appcheck.FirebaseAppCheck;
 import com.google.firebase.appcheck.debug.internal.DebugAppCheckProvider;
 
 /**
- * Implementation of an {@link AppCheckProviderFactory} that builds {@link DebugAppCheckProvider}s.
+ * Implementation of an {@link AppCheckProviderFactory} that builds {@code DebugAppCheckProvider}s.
  */
 public class DebugAppCheckProviderFactory implements AppCheckProviderFactory {
 
@@ -30,10 +31,10 @@ public class DebugAppCheckProviderFactory implements AppCheckProviderFactory {
   private DebugAppCheckProviderFactory() {}
 
   /**
-   * Gets an instance of this class for installation into a {@link
-   * com.google.firebase.appcheck.FirebaseAppCheck} instance. If no debug secret is found in {@link
-   * android.content.SharedPreferences}, a new debug secret will be generated and printed to the
-   * logcat. The debug secret should then be added to the allow list in the Firebase Console.
+   * Gets an instance of this class for installation into a {@link FirebaseAppCheck} instance. If no
+   * debug secret is found in {@link android.content.SharedPreferences}, a new debug secret will be
+   * generated and printed to the logcat. The debug secret should then be added to the allow list in
+   * the Firebase Console.
    */
   @NonNull
   public static DebugAppCheckProviderFactory getInstance() {

appcheck/firebase-appcheck-interop/api.txt

@@ -15,11 +15,5 @@ package com.google.firebase.appcheck.interop {
     method public void onAppCheckTokenChanged(@NonNull com.google.firebase.appcheck.AppCheckTokenResult);
   }
 
-  public interface InternalAppCheckTokenProvider {
-    method public void addAppCheckTokenListener(@NonNull com.google.firebase.appcheck.interop.AppCheckTokenListener);
-    method @NonNull public com.google.android.gms.tasks.Task<com.google.firebase.appcheck.AppCheckTokenResult> getToken(boolean);
-    method public void removeAppCheckTokenListener(@NonNull com.google.firebase.appcheck.interop.AppCheckTokenListener);
-  }
-
 }
 

appcheck/firebase-appcheck-interop/src/main/java/com/google/firebase/appcheck/interop/InternalAppCheckTokenProvider.java

@@ -18,6 +18,7 @@
 import com.google.android.gms.tasks.Task;
 import com.google.firebase.appcheck.AppCheckTokenResult;
 
+/** @hide */
 public interface InternalAppCheckTokenProvider {
 
   /**

appcheck/firebase-appcheck-playintegrity/src/main/java/com/google/firebase/appcheck/playintegrity/PlayIntegrityAppCheckProviderFactory.java

@@ -18,21 +18,19 @@
 import com.google.firebase.FirebaseApp;
 import com.google.firebase.appcheck.AppCheckProvider;
 import com.google.firebase.appcheck.AppCheckProviderFactory;
+import com.google.firebase.appcheck.FirebaseAppCheck;
 import com.google.firebase.appcheck.playintegrity.internal.PlayIntegrityAppCheckProvider;
 
 /**
- * Implementation of an {@link AppCheckProviderFactory} that builds {@link
- * PlayIntegrityAppCheckProvider}s. This is the default implementation.
+ * Implementation of an {@link AppCheckProviderFactory} that builds <br>
+ * {@link PlayIntegrityAppCheckProvider}s. This is the default implementation.
  */
 public class PlayIntegrityAppCheckProviderFactory implements AppCheckProviderFactory {
 
   private static final PlayIntegrityAppCheckProviderFactory instance =
       new PlayIntegrityAppCheckProviderFactory();
 
-  /**
-   * Gets an instance of this class for installation into a {@link
-   * com.google.firebase.appcheck.FirebaseAppCheck} instance.
-   */
+  /** Gets an instance of this class for installation into a {@link FirebaseAppCheck} instance. */
   @NonNull
   public static PlayIntegrityAppCheckProviderFactory getInstance() {
     return instance;

appcheck/firebase-appcheck-safetynet/src/main/java/com/google/firebase/appcheck/safetynet/SafetyNetAppCheckProviderFactory.java

@@ -18,11 +18,12 @@
 import com.google.firebase.FirebaseApp;
 import com.google.firebase.appcheck.AppCheckProvider;
 import com.google.firebase.appcheck.AppCheckProviderFactory;
+import com.google.firebase.appcheck.FirebaseAppCheck;
 import com.google.firebase.appcheck.safetynet.internal.SafetyNetAppCheckProvider;
 
 /**
- * Implementation of an {@link AppCheckProviderFactory} that builds {@link
- * SafetyNetAppCheckProvider}s. This is the default implementation.
+ * Implementation of an {@link AppCheckProviderFactory} that builds <br>
+ * {@link SafetyNetAppCheckProvider}s. This is the default implementation.
  *
  * @deprecated Use {@code PlayIntegrityAppCheckProviderFactory} instead.
  */
@@ -35,8 +36,7 @@ public class SafetyNetAppCheckProviderFactory implements AppCheckProviderFactory
   private SafetyNetAppCheckProviderFactory() {}
 
   /**
-   * Gets an instance of this class for installation into a {@link
-   * com.google.firebase.appcheck.FirebaseAppCheck} instance.
+   * Gets an instance of this class for installation into a {@link FirebaseAppCheck} instance.
    *
    * @deprecated Use {@code PlayIntegrityAppCheckProviderFactory#getInstance} instead.
    */

appcheck/firebase-appcheck/src/main/java/com/google/firebase/appcheck/AppCheckProvider.java

@@ -19,9 +19,9 @@
 
 /**
  * Interface for a provider that generates {@link AppCheckToken}s. This provider can be called at
- * any time by any Firebase library that depends (optionally or otherwise) on {@link
- * AppCheckToken}s. This provider is responsible for determining if it can create a new token at the
- * time of the call and returning that new token if it can.
+ * any time by any Firebase library that depends (optionally or otherwise) on <br>
+ * {@link AppCheckToken}s. This provider is responsible for determining if it can create a new token
+ * at the time of the call and returning that new token if it can.
  */
 public interface AppCheckProvider {