Cel udostępniania treści z sieci umożliwia przeglądarce internetowej nawigowanie do treści udostępnionych 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ępniania 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 dopiero zaczynają korzystać z tej technologii, mogą skorzystać z przewodnika po integracji.
Pełne wyjaśnienie implementacji celu Udostępnianie przez internet 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 pliku demonstracyjnym z działalnoś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 internecie szczegóły dotyczące udostępniania, które obsługuje, np. które adresy URL otwierać, jaką metodę stosować i jakie typy mime obsługiwać.
Jest to realizowane za pomocą obiektu JSON udostępnionego usłudze zaufana aktywność internetowa za pomocą zasobu ciągu znaków. Pola te są takie same jak pole share_target dostępne w pliku manifestu internetowego, i można je dodawać do ciągu w polu strings.xml, prawie w takim samym stanie, z 2 ważnymi wyjątkami:
- Wartość atrybutu action musi być pełnym adresem URL, łącznie z pochodzeniem.
- Musisz użyć znaku ucieczki, aby każdy znak
"został zamieniony na\".
Oto jak wygląda sekcja share_target w pliku https://scrapbook-pwa.web.app/manifest.json:
{
...
"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 DelegationService jest 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, które 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 PWA 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 sieci, jest uproszczony przez bibliotekę android-browser-helper.
Aby dowiedzieć się więcej o korzystaniu z interfejsu API w aplikacji PWA, przeczytaj artykuł o celu udostępniania treści w internecie, a aby dowiedzieć się, jak udostępniać treści z aplikacji Progressive Web App, przeczytaj 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łowe. 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 JSON w pliku strings.xml jest poprawny.