启用实验性功能
重要提示:此文档不适用于您当前选择的格式电子邮件!
AMP 实验性组件是已发布但尚未准备好广泛使用的功能,因此它们受 实验性 状态保护。
开发人员和用户可以选择在这些功能完全发布之前使用它们。但应谨慎使用,因为它们可能包含错误或产生意外的副作用。
以下是当前处于实验状态并已准备好供开发人员测试以获得首批用户反馈的组件列表
- amp-accordion-v1.0
- amp-action-macro-v0.1
- amp-audio-v0.1
- amp-audio-v1.0
- amp-base-carousel-v0.1
- amp-base-carousel-v1.0
- amp-dailymotion-v0.1
- amp-dailymotion-v1.0
- amp-date-countdown-v1.0
- amp-embedly-card-v1.0
- amp-facebook-v1.0
- amp-fit-text-v1.0
- amp-iframe-v1.0
- amp-image-slider-v1.0
- amp-inline-gallery-v1.0
- amp-instagram-v1.0
- amp-lightbox-gallery-v1.0
- amp-lightbox-v1.0
- amp-mega-menu-v0.1
- amp-next-page-v0.1
- amp-selector-v1.0
- amp-sidebar-v0.2
- amp-sidebar-v1.0
- amp-social-share-v1.0
- amp-soundcloud-v1.0
- amp-story-panning-media-v0.1
- amp-stream-gallery-v0.1
- amp-stream-gallery-v1.0
- amp-tiktok-v0.1
- amp-timeago-v1.0
- amp-truncate-text-v0.1
- amp-twitter-v1.0
- amp-video-v1.0
- amp-wordpress-embed-v1.0
- amp-youtube-v1.0
选择加入 AMP Beta 通道
AMP Beta 通道是一种让浏览器选择使用较新版本 AMP JS 库的方法。
AMP Beta 通道版本 可能不太稳定,并且可能包含并非所有用户都可用的功能。如果您想帮助测试新版本的 AMP、报告错误或构建需要尚未向所有人提供的新功能的文档,请选择此选项。
选择加入 Beta 通道非常适合
- 测试和使用尚未向所有用户提供的新功能。
- 在质量保证 (QA) 中使用,以确保您的站点与下一版本的 AMP 兼容。
如果您发现仅在 Beta 通道版本的 AMP 中出现的问题,请提交问题并描述问题。始终包含一个可以重现问题的页面的 URL。
要使您的浏览器选择加入 AMP Beta 通道,请转到AMP 实验页面并激活“AMP Beta 通道”实验。要获取有关 AMP 的重要/重大更改的通知,请订阅 amphtml-announce 邮件列表。
启用实验性组件
从 cdn.ampproject.org 提供
对于从 https://*.cdn.ampproject.org
提供的内容,请转到 Google AMP Cache 子域上的 /experiments.html
,并通过打开(或关闭)它们来启用(或禁用)任何实验性组件。
例如,要在源自 www.example.com
的缓存 AMP 页面上启用实验,请转到 www-example-com.cdn.ampproject.org/experiments.html
。
实验选择加入保存在 localStorage
中,并且仅在从当前域提供的 AMP 页面上启用实验。
从其他域提供
对于从非 CDN 域提供的内容,可以使用开发工具控制台中的以下内容切换实验:
AMP.toggleExperiment('experiment')
任何包含实验性功能的 AMP 文件都将无法通过AMP 验证。删除这些实验性组件,以用于可投入生产的 AMP 文档。
为特定文档启用实验
文档可以选择加入某些实验。为此,请在 HTML 文档的 head 中、您的 AMP 脚本 (https://cdn.ampproject.org/v0.js
) 之前放置一个名为 amp-experiments-opt-in
的 meta 标签。其内容值是要选择加入的实验 ID 的逗号分隔字符串。
<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>
这样做,将为文档的所有访问者启用指定的实验。但是,并非所有实验都允许文档级别的选择加入。有关允许的实验的完整列表,请参阅项目 prod-config.json
文件中的 allow-doc-opt-in
属性。请注意,文档选择加入可以被用户选择退出覆盖。
源试用
源试用使开发人员能够在生产中使用实验性功能并提供基本反馈。
传统上,处于实验模式的功能可以在开发中使用,但不能推送到生产中。借助源试用,感兴趣的开发人员可以选择在生产中测试实验性功能,并具有以下预期:
- 测试的时间有限。
- 该功能在源试用后可能会进行一些更改。
源试用提供了一个在功能完全上线之前实施该功能并从中受益的机会。该功能将驻留在开发人员的站点上,而不是受实验保护,并且反馈可以直接影响该功能的方向。
启用源试用
在每个使用源试用实验的页面上的 <head>
标记内包含以下 <meta>
标记
<meta name="amp-experiment-token" content="{copy your token here}">
"amp-experiment-token"
是文字字符串 "amp-experiment-token"
。而不是令牌本身(该令牌进入内容属性)或实验的名称。