javascript - 确定 Office 加载项的首次运行

Question

我目前正在尝试学习开发 Office 插件的最佳实践。我关注了this tutorial从 Microsoft 开始。

Microsoft 指南指出，您应该拥有解释如何使用插件的首次运行体验。我想知道确定插件是否第一次加载的最佳方法是什么，如果是，如何显示不同的页面？是否可以在 list 中设置不同的初始页面，或者我是否需要使用 Javascript 以某种方式在第一次运行时重定向？

Answer 1

很高兴听到有人关心用户体验，甚至想整理首次运行指南；)

Can different initial pages be set within the manifest, ...?

不， list 没有任何内容指向您的 Web 应用程序的“一次性使用”页面。

... or do I need to use Javascript to redirect on the first run in some manner?

是的，这正是您想要做的。如果用户第一次运行您的应用程序，您可能会重定向到一些指南页面；你也可以显示和隐藏 <div>如果您使用单页应用程序来预览用户指南，请使用图层。我什至看到一个“花哨”的应用程序，它在您的应用程序控件的顶部显示透明层并附有解释，看起来非常酷，有点像是第一次使用的上下文手册。

I was wondering what the best method of determining whether or not the addin was loaded for the first time and if it was...?

在我看来，最好的方法是使用 RoamingSettings如果用户阅读了您的指南并且不想再看到它，则反对设置某种标记。此对象将在 Office.initialize 之后立即可用, 因此您可以尝试获取此标记( key )并根据其重定向到您的应用程序页面或指南页面。