AMP

Włączanie funkcji eksperymentalnych

Eksperymentalne składniki AMP to wydane funkcje, które nie są jeszcze gotowe do powszechnego stosowania, więc są chronione przez status eksperymentalny.

Programiści i użytkownicy mogą zdecydować się na korzystanie z tych funkcji przed ich pełnym wydaniem. Należy jednak zachować ostrożność, ponieważ mogą one zawierać błędy lub mieć nieoczekiwane skutki uboczne.

Istnieje ryzyko, że niektóre eksperymenty nigdy nie zostaną wykorzystane w projekcie AMP jako funkcje.

Jest to lista składników, które mają obecnie status eksperymentalny i są gotowe do testowania przez programistów w celu uzyskania pierwszych informacji zwrotnych od użytkowników:

Wybierz kanał AMP Beta

Kanał AMP Beta to sposób na ustawienie przeglądarki do korzystania z nowszej wersji bibliotek JS AMP.

Wydanie z kanału AMP Beta  może być mniej stabilne i może zawierać funkcje niedostępne dla wszystkich użytkowników. Wybierz je, jeśli chcesz pomóc w testowaniu nowych wersji AMP, zgłaszaniu błędów lub tworzeniu dokumentów wymagających nowej funkcji, która nie jest jeszcze dostępna dla wszystkich.

Beta Channel to świetny wybór:

  • do testowania i zabawy nowymi funkcjami, które nie są jeszcze dostępne dla wszystkich użytkowników.
  • do stosowania w zapewnieniu jakości (QA) w celu zapewnienia, że witryna jest zgodna z następną wersją AMP.

Jeśli znajdziesz problem, który wydaje się występować tylko w wersji AMP z Beta Channel, zgłoś problem z opisem. Zawsze dołączaj adres URL do strony z odtworzeniem problemu.

Aby ustawić przeglądarkę do korzystania z kanału AMP Beta Channel, przejdź do strony eksperymentów AMP i aktywuj eksperyment „AMP Beta Channel”. Aby otrzymywać powiadomienia o ważnych/przełomowych zmianach dotyczących AMP, zapisz się na listę mailingową amphtml-announce.

Włączanie składnika eksperymentalnego

Serwowanego z cdn.ampproject.org

Aby pobierać treści serwowane z https://*.cdn.ampproject.org, przejdź do pliku /experiments.html w subdomenie serwera Google AMP Cache i przełącznikiem włącz (lub wyłącz) żądany eksperymentalny składnik.

Aby włączyć na przykład eksperymenty na buforowanych stronach AMP, których źródłem jest domena www.example.com, przejdź do adresu wwww-example-com.cdn.ampproject.org/experiments.html.

Włączone eksperymenty są zapisywane w lokalizacji localStorage i umożliwiają eksperymenty tylko na stronach AMP serwowanych z bieżącej domeny.

Serwowane z innych domen

Eksperymenty dla treści serwowanych z domen innych niż CDN można przełączać w konsoli devtools za pomocą:

AMP.toggleExperiment('experiment');

Żaden plik AMP zawierający funkcje eksperymentalne nie przejdzie walidacji AMP. Eksperymentalne składniki należy usunąć z gotowych produkcyjnych dokumentów AMP.

Włączanie eksperymentu dla konkretnego dokumentu

Dokument może włączać określone eksperymenty. W tym celu należy w nagłówku dokumentu HTML umieścić tag meta nazwy amp-experiments-opt-in przed skryptem AMP (https://cdn.ampproject.org/v0.js). Zawarta w nim wartość to rozdzielany przecinkami ciąg identyfikatorów eksperymentów, które mają zostać włączone.

<head>
  ...
  <meta name="amp-experiments-opt-in" content="experiment-a,experiment-b" />
  <!-- The meta tag needs to be placed before the AMP runtime script.-->
  <script async src="https://cdn.ampproject.org/v0.js"></script>
  ...
</head>

W ten sposób określone eksperymenty zostaną włączone dla wszystkich odwiedzających dokument. Nie wszystkie eksperymenty pozwalają jednak na ich włączenie na poziomie dokumentu. Pełna lista dozwolonych eksperymentów znajduje się w atrybucie allow-doc-opt-in w pliku projektu prod-config.json. Zauważ, że opcję włączenia dokumentu może zostać zastąpiona przez opcję wyłączenia przez użytkownika.

Próby źródła

Próby źródła umożliwiają programistom wykorzystanie funkcji eksperymentalnej w produkcji i dostarczają niezbędnych informacji zwrotnych.

Funkcja w trybie eksperymentalnym tradycyjnie może być wykorzystywana podczas programowania, ale nie w produkcji. Dzięki próbom źródła zainteresowani programiści mogą decydować się na przetestowanie eksperymentalnej funkcji w produkcji, z następującymi oczekiwaniami:

  • Test jest ograniczony czasowo.
  • Funkcja prawdopodobnie przejdzie pewne zmiany po próbach źródła.

Próby źródła dają możliwość wdrożenia i skorzystania z nowej funkcji, zanim stanie się ona w pełni dostępna. Funkcja będzie dostępna w witrynie programisty, zamiast być chroniona statusem eksperymentu, a informacje zwrotne mogą mieć bezpośredni wpływ na kierunek rozwoju funkcji.

Włączanie próby źródła

Dołącz następujący znacznik <meta> w sekcji <head> każdej strony używającej eksperymentu w ramach próby źródła:

<meta name="amp-experiment-token" content="{copy your token here}" />

Uwaga: "amp-experiment-token" to ciąg literału, "amp-experiment-token". Nie jest to sam token (podawany w atrybucie content) ani nazwa eksperymentu.