ApiHelperForQ.java
/*
* Copyright 2022 The Android Open Source Project
*
* 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
*
* http://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.
*/
package androidx.webkit.internal;
import android.os.Build;
import android.webkit.WebSettings;
import android.webkit.WebView;
import android.webkit.WebViewRenderProcess;
import androidx.annotation.DoNotInline;
import androidx.annotation.NonNull;
import androidx.annotation.Nullable;
import androidx.annotation.RequiresApi;
import androidx.webkit.WebViewRenderProcessClient;
import java.util.concurrent.Executor;
/**
* Utility class to use new APIs that were added in Q (API level 29).
* These need to exist in a separate class so that Android framework can successfully verify
* classes without encountering the new APIs.
*/
@RequiresApi(Build.VERSION_CODES.Q)
public class ApiHelperForQ {
private ApiHelperForQ() {
}
/**
* @see WebSettings#setForceDark(int)
* @deprecated in 31
*/
@DoNotInline
@Deprecated
public static void setForceDark(@NonNull WebSettings webSettings, int forceDark) {
webSettings.setForceDark(forceDark);
}
/**
* @see WebSettings#getForceDark()
* @deprecated in 31
*/
@DoNotInline
@Deprecated
public static int getForceDark(@NonNull WebSettings webSettings) {
return webSettings.getForceDark();
}
/**
* @see WebView#getWebViewRenderProcess()
*/
@DoNotInline
@Nullable
public static WebViewRenderProcess getWebViewRenderProcess(@NonNull WebView webView) {
return webView.getWebViewRenderProcess();
}
/**
* @see WebViewRenderProcess#terminate()
*/
@DoNotInline
public static boolean terminate(@NonNull WebViewRenderProcess webViewRenderProcess) {
return webViewRenderProcess.terminate();
}
/**
* @see WebView#setWebViewRenderProcessClient(Executor,
* android.webkit.WebViewRenderProcessClient)
*/
@DoNotInline
public static void setWebViewRenderProcessClient(@NonNull WebView webView,
@NonNull Executor executor,
@Nullable WebViewRenderProcessClient client) {
WebViewRenderProcessClientFrameworkAdapter clientAdapter =
client != null ? new WebViewRenderProcessClientFrameworkAdapter(client) : null;
webView.setWebViewRenderProcessClient(executor, clientAdapter);
}
/**
* @see WebView#setWebViewRenderProcessClient(android.webkit.WebViewRenderProcessClient)
*/
@DoNotInline
public static void setWebViewRenderProcessClient(@NonNull WebView webView,
@Nullable WebViewRenderProcessClient client) {
WebViewRenderProcessClientFrameworkAdapter clientAdapter =
client != null ? new WebViewRenderProcessClientFrameworkAdapter(client) : null;
webView.setWebViewRenderProcessClient(clientAdapter);
}
/**
* @see WebView#getWebViewRenderProcessClient()
*/
@DoNotInline
@Nullable
public static android.webkit.WebViewRenderProcessClient getWebViewRenderProcessClient(
@NonNull WebView webView) {
return webView.getWebViewRenderProcessClient();
}
}