判断Office插件的第一个-运行

Determining First-Run of Office Add-In

我目前正在尝试学习开发 Office 插件的最佳实践。我已经跟随 this tutorial 来自 Microsoft 开始了。

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

很高兴听到有人关心用户体验,甚至想先把它们放在一起 运行 指南;)

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

不,清单没有任何指向您的 Web 应用程序的 "one time use" 页面的内容。

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

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

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 后立即可用,因此您可以尝试获取此标记(密钥)并根据此重定向到您的应用程序页面或指南页面。