Cel udostępniania w internecie umożliwia PWA otrzymywanie udostępnianych treści z innych aplikacji zainstalowanych na urządzeniu. Z tej funkcji mogą korzystać na przykład aplikacje do edycji zdjęć, aby odbierać obrazy z aplikacji aparatu, lub sieci społecznościowe, aby odbierać obrazy i filmy do udostępnienia.
Od wersji 86 Chrome docelowe udostępnianie w internecie jest dostępne również dla aplikacji korzystających z zaufanej aktywności w internecie. PWA powinna działać od razu, ale w aplikacji na Androida trzeba wprowadzić kilka zmian.
W tym artykule zakładamy, że deweloper zna zaufane działania w internecie. Czytelnicy, którzy nie znają tej technologii, mogą zacząć od przewodnika po integracji.
Podobnie pełne wyjaśnienie implementacji celu Udostępnianie przez Web w PWA wykracza poza zakres tego artykułu. Więcej informacji na ten temat znajdziesz w tym artykule.
W tym artykule jako PWA zostanie użyta aplikacja demonstracyjna https://scrapbook-pwa.web.app/. Jej kod źródłowy jest dostępny na GitHub, a aplikacja na Androida opiera się na podstawowym demonstracyjnym PWA Aktywności w zaufanym internecie.
Dodawanie do aplikacji na Androida celu udostępniania przez internet
Aby zmodyfikować istniejące aplikacje korzystające z zaufanej aktywności w internecie w celu implementacji celu udostępniania w internecie, musisz zmodyfikować 3 pliki:
build.gradle
Biblioteka android-browser-helper została zaktualizowana i obsługuje teraz cel udostępniania w przeglądarce. Najpierw zaktualizuj aplikację do wersji 2.0.1 lub nowszej.
dependencies {
...
implementation 'com.google.androidbrowserhelper:androidbrowserhelper:2.2.0'
}
res/strings.xml
Aplikacja musi przekazać zaufanej aktywności w sieci szczegóły dotyczące obsługiwanych funkcji udostępniania, takie jak adresy URL do otwierania, metodę do użycia i obsługiwane typy mime.
Jest to realizowane za pomocą obiektu JSON udostępnionego usłudze zaufana aktywność internetowa za pomocą zasobu ciągu znaków. Te pola są takie same jak pole share_target dostępne w pliku manifestu internetowego i można je dodać do ciągu w polu strings.xml, prawie w takiej samej formie. Należy jednak pamiętać o 2 ważnych kwestiach:
- Wartość atrybutu action musi być pełnym adresem URL, łącznie z pochodzeniem.
- Konieczne jest stosowanie znaku ucieczki przed podwójnym cudzysłowem, aby każdy element
"był zapisywany jako\".
Sekcja share_target w pliku https://scrapbook-pwa.web.app/manifest.json wygląda tak:
{
...
"share_target": {
"action": "/_share-target",
"enctype": "multipart/form-data",
"method": "POST",
"params": {
"files": [{
"name": "media",
"accept": [
"audio/*",
"image/*",
"video/*"
]
}]
}
},
...
}
Nowy element ciągu znaków będzie wyglądał tak:
<string name="share_target">
{
\"action\": \"https://twa-web-scrapbook.web.app/_share-target\",
\"method\": \"POST\",
\"enctype\": \"multipart/form-data\",
\"params\": {
\"files\": [{
\"name\": \"media\",
\"accept\": [\"image/*\", \"audio/*\", \"video/*\"]
}]
}
}
</string>
AndroidManifest.xml
W pliku manifestu Androida należy wprowadzić kilka zmian. Najpierw musimy się upewnić, że element DelegationService został zadeklarowany, wyeksportowany i włączony.
Programiści, którzy stworzyli aplikację na podstawie podstawowego szablonu, będą już mieć uwzględnioną usługę. Tagowanie powinno znajdować się w tagu aplikacji i wyglądać tak:
<service
android:name="com.google.androidbrowserhelper.trusted.DelegationService"
android:enabled="true"
android:exported="true">
<intent-filter>
<action android:name="android.support.customtabs.trusted.TRUSTED_WEB_ACTIVITY_SERVICE"/>
<category android:name="android.intent.category.DEFAULT"/>
</intent-filter>
</service>
Do tagu aktywności LauncherActivity należy też dodać 2 nowe elementy:
- tag meta-data, który odwołuje się do pliku JSON zdefiniowanego w pliku strings.xml;
– intent-filter, który określa, jakie typy mime aplikacja może obsługiwać w przypadku innych aplikacji na urządzeniu.
<meta-data
android:name="android.support.customtabs.trusted.METADATA_SHARE_TARGET"
android:resource="@string/share_target"/>
<intent-filter>
<action android:name="android.intent.action.SEND" />
<action android:name="android.intent.action.SEND_MULTIPLE" />
<category android:name="android.intent.category.DEFAULT" />
<data android:mimeType="audio/*" />
<data android:mimeType="image/*" />
<data android:mimeType="video/*" />
</intent-filter>
Jak widać w powyższym znaczniku, do każdego elementu mime-type zadeklarowanego w pliku JSON share_target należy dodać element data.
Podsumowanie
Integracja z celami udostępniania w internecie umożliwia lepsze zintegrowanie aplikacji internetowych w ramach zaufanej aktywności w internecie z innymi aplikacjami zainstalowanymi na urządzeniu z Androidem.
Jak opisano powyżej, dodatkowy znacznik znaczeń potrzebny do dodania obsługi interfejsu API w dotychczasowej aplikacji na Androida, która korzysta z zaufanej aktywności w internecie, jest uproszczony przez pakiet android-browser-helper.
Aby dowiedzieć się więcej o używaniu interfejsu API w aplikacji Progressive Web App, przeczytaj artykuł o celu udostępniania treści w przeglądarce oraz artykuł o interfejsie Web Share API.
Rozwiązywanie problemów
Podczas udostępniania pliku z innej aplikacji moja aplikacja nie jest wyświetlana jako opcja.
Jeśli aplikacja nie jest widoczna jako opcja, oznacza to, że intent-filter jest nieprawidłowy. Sprawdź, czy znaczniki intent-filter zawierają prawidłowe działania, kategorię i mime-types obsługiwane przez aplikację.
Moja aplikacja jest widoczna jako opcja, PWA jest uruchomiona, ale dane nie są udostępniane.
Może się tak zdarzyć z kilku powodów. Oto lista kontrolna:
- Sprawdź, czy weryfikacja Digital Asset Links zakończyła się sukcesem.
- Sprawdź, czy plik JSON w pliku strings.xml jest poprawny.