Android AdvancedWebView
1.0.0
Усовершенствованный компонент WebView для Android, который работает как предназначенное из коробки
Объявите репозиторий Gradle в вашем корневом build.gradle
allprojects {
repositories {
maven { url " https://jitpack.io " }
}
} Объявите зависимость Gradle в build.gradle модуля вашего приложения.
dependencies {
implementation ' com.github.delight-im:Android-AdvancedWebView:v3.2.1 '
}< uses-permission android : name = " android.permission.INTERNET " />< im .delight.android.webview.AdvancedWebView
android : id = " @+id/webview "
android : layout_width = " match_parent "
android : layout_height = " match_parent " /> public class MyActivity extends Activity implements AdvancedWebView . Listener {
private AdvancedWebView mWebView ;
@ Override
protected void onCreate ( Bundle savedInstanceState ) {
super . onCreate ( savedInstanceState );
setContentView ( R . layout . activity_my );
mWebView = ( AdvancedWebView ) findViewById ( R . id . webview );
mWebView . setListener ( this , this );
mWebView . setMixedContentAllowed ( false );
mWebView . loadUrl ( "http://www.example.org/" );
// ...
}
@ SuppressLint ( "NewApi" )
@ Override
protected void onResume () {
super . onResume ();
mWebView . onResume ();
// ...
}
@ SuppressLint ( "NewApi" )
@ Override
protected void onPause () {
mWebView . onPause ();
// ...
super . onPause ();
}
@ Override
protected void onDestroy () {
mWebView . onDestroy ();
// ...
super . onDestroy ();
}
@ Override
protected void onActivityResult ( int requestCode , int resultCode , Intent intent ) {
super . onActivityResult ( requestCode , resultCode , intent );
mWebView . onActivityResult ( requestCode , resultCode , intent );
// ...
}
@ Override
public void onBackPressed () {
if (! mWebView . onBackPressed ()) { return ; }
// ...
super . onBackPressed ();
}
@ Override
public void onPageStarted ( String url , Bitmap favicon ) { }
@ Override
public void onPageFinished ( String url ) { }
@ Override
public void onPageError ( int errorCode , String description , String failingUrl ) { }
@ Override
public void onDownloadRequested ( String url , String suggestedFilename , String mimeType , long contentLength , String contentDisposition , String userAgent ) { }
@ Override
public void onExternalPageRequest ( String url ) { }
}android.app.Fragment ) Примечание. Если вы используете класс Fragment из библиотеки поддержки ( android.support.v4.app.Fragment ), пожалуйста, обратитесь к следующему разделу (см. Ниже) вместо этого.
public class MyFragment extends Fragment implements AdvancedWebView . Listener {
private AdvancedWebView mWebView ;
public MyFragment () { }
@ Override
public View onCreateView ( LayoutInflater inflater , ViewGroup container , Bundle savedInstanceState ) {
View rootView = inflater . inflate ( R . layout . fragment_my , container , false );
mWebView = ( AdvancedWebView ) rootView . findViewById ( R . id . webview );
mWebView . setListener ( this , this );
mWebView . setMixedContentAllowed ( false );
mWebView . loadUrl ( "http://www.example.org/" );
// ...
return rootView ;
}
@ SuppressLint ( "NewApi" )
@ Override
public void onResume () {
super . onResume ();
mWebView . onResume ();
// ...
}
@ SuppressLint ( "NewApi" )
@ Override
public void onPause () {
mWebView . onPause ();
// ...
super . onPause ();
}
@ Override
public void onDestroy () {
mWebView . onDestroy ();
// ...
super . onDestroy ();
}
@ Override
public void onActivityResult ( int requestCode , int resultCode , Intent intent ) {
super . onActivityResult ( requestCode , resultCode , intent );
mWebView . onActivityResult ( requestCode , resultCode , intent );
// ...
}
@ Override
public void onPageStarted ( String url , Bitmap favicon ) { }
@ Override
public void onPageFinished ( String url ) { }
@ Override
public void onPageError ( int errorCode , String description , String failingUrl ) { }
@ Override
public void onDownloadRequested ( String url , String suggestedFilename , String mimeType , long contentLength , String contentDisposition , String userAgent ) { }
@ Override
public void onExternalPageRequest ( String url ) { }
}android.support.v4.app.Fragment ) Используйте код для нормального использования Fragment , как показано выше
Изменять
mWebView . setListener ( this , this );к
mWebView . setListener ( getActivity (), this ); Добавить следующий код в родительскую FragmentActivity , чтобы направить результаты FragmentActivity в соответствующий экземпляр Fragment
public class MyActivity extends FragmentActivity implements AdvancedWebView . Listener {
@ Override
public void onActivityResult ( int requestCode , int resultCode , Intent intent ) {
super . onActivityResult ( requestCode , resultCode , intent );
if ( mFragment != null ) {
mFragment . onActivityResult ( requestCode , resultCode , intent );
}
}
} -keep class * extends android.webkit.WebChromeClient { *; }
-dontwarn im.delight.android.webview.**
Если вы хотите обслуживать сайты или просто отдельные ресурсы над простым http вместо https , обычно нечего делать, если вы нацеливаете на Android 8.1 (API -уровень 27) или ранее. На Android 9 (API -уровне 28) и позже, однако, поддержка Clartext отключена по умолчанию. Возможно, вам придется установить android:usesCleartextTraffic="true" на элементе <application> в AndroidManifest.xml или предоставить пользовательскую конфигурацию безопасности сети.
Оптимизирован для лучшей производительности и безопасности
Особенности исправлены в версиях Android
Загрузки файлов обрабатываются автоматически (проверьте доступность с помощью AdvancedWebView.isFileUploadAvailable() )
multiple атрибутов в HTML) поддерживаются на Android 5.0+. Приложение, которое используется для выбора файлов (то есть обычно галерея или приложения файлового менеджера), должно предоставить элементы управления для выбора нескольких файлов, которых нет.JavaScript и WebStorage включены по умолчанию
Включает локализацию для 25 самых широко распространенных языков
Получить обратные вызовы, когда страницы запускаются/завершают загрузку или имеют ошибки
@ Override
public void onPageStarted ( String url , Bitmap favicon ) {
// a new page started loading
}
@ Override
public void onPageFinished ( String url ) {
// the new page finished loading
}
@ Override
public void onPageError ( int errorCode , String description , String failingUrl ) {
// the new page failed to load
}Загрузки обрабатываются автоматически и могут слушать
@ Override
public void onDownloadRequested ( String url , String suggestedFilename , String mimeType , long contentLength , String contentDisposition , String userAgent ) {
// some file is available for download
// either handle the download yourself or use the code below
if ( AdvancedWebView . handleDownload ( this , url , suggestedFilename )) {
// download successfully handled
}
else {
// download couldn't be handled because user has disabled download manager app on the device
// TODO show some notice to the user
}
} Включить поддержку геолокации (потребности <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" /> )
mWebView . setGeolocationEnabled ( true );Добавить пользовательские заголовки HTTP в дополнение к те, которые отправляются в реализацию веб -браузера
mWebView . addHttpHeader ( "X-Requested-With" , "My wonderful app" );Определите пользовательский набор разрешенных имен хоста и получите обратные вызовы для всех других имен хоста.
mWebView . addPermittedHostname ( "example.org" );и
@ Override
public void onExternalPageRequest ( String url ) {
// the user tried to open a page from a non-permitted hostname
}Предотвратить кэширование HTML -страниц
boolean preventCaching = true ;
mWebView . loadUrl ( "http://www.example.org/" , preventCaching );Проверьте на наличие альтернативных браузеров, установленных на устройстве
if ( AdvancedWebView . Browsers . hasAlternative ( this )) {
AdvancedWebView . Browsers . openUrl ( this , "http://www.example.org/" );
}Отключить файлы cookie
// disable third-party cookies only
mWebView . setThirdPartyCookiesEnabled ( false );
// or disable cookies in general
mWebView . setCookiesEnabled ( false );Разрешить или запретить (как пассивное, так и активное) смешанное содержимое (HTTP -контент загружается внутри сайтов HTTPS)
mWebView . setMixedContentAllowed ( true );
// or
mWebView . setMixedContentAllowed ( false );Переключение между мобильным и режимом настольного компьютера
mWebView . setDesktopMode ( true );
// or
// mWebView.setDesktopMode(false); Загрузите HTML -файл из «Assets» (например, app/src/main/assets/html/index.html )
mWebView . loadUrl ( "file:///android_asset/html/index.html" );Загрузите HTML -файл с SD -карты
// <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
if ( Environment . getExternalStorageState (). equals ( Environment . MEDIA_MOUNTED )) {
mWebView . getSettings (). setAllowFileAccess ( true );
mWebView . loadUrl ( "file:///sdcard/Android/data/com.my.app/my_folder/index.html" );
}Загрузите HTML -источник текста и отображение в качестве страницы
myWebView . loadHtml ( "<html>...</html>" );
// or
final String myBaseUrl = "http://www.example.com/" ;
myWebView . loadHtml ( "<html>...</html>" , myBaseUrl );Включить поддержку с несколькими Window
myWebView . getSettings (). setSupportMultipleWindows ( true );
// myWebView.getSettings().setJavaScriptEnabled(true);
// myWebView.getSettings().setJavaScriptCanOpenWindowsAutomatically(true);
myWebView . setWebChromeClient ( new WebChromeClient () {
@ Override
public boolean onCreateWindow ( WebView view , boolean isDialog , boolean isUserGesture , Message resultMsg ) {
AdvancedWebView newWebView = new AdvancedWebView ( MyNewActivity . this );
// myParentLayout.addView(newWebView, LayoutParams.MATCH_PARENT, LayoutParams.MATCH_PARENT);
WebView . WebViewTransport transport = ( WebView . WebViewTransport ) resultMsg . obj ;
transport . setWebView ( newWebView );
resultMsg . sendToTarget ();
return true ;
}
}Все взносы приветствуются! Если вы хотите внести свой вклад, сначала создайте проблему, чтобы обсудить вашу функцию, проблему или вопрос.
Этот проект лицензирован в соответствии с условиями лицензии MIT.
