SDK部署问题排查指南

在部署软件开发工具包(SDK)时,可能会遇到各种问题。本文将介绍一些常见的问题和场景,帮助排查和识别部署问题。

确保满足SDK的先决条件

在开始部署之前,请确保服务器运行的是Lync Server 2013 CU1或更高版本,或者更好的是Skype for Business 2015。了解SDK的先决条件是非常重要的。

代码必须位于面向互联网的网站或本地主机上

尽管听起来有些矛盾,但从非互联网面向或本地主机风格的域实例化SDK似乎存在问题。以下是一些支持和不支持的域名示例:

  • hostname.domainname - 支持
  • http://code.telewebica.net.au/ - 支持
  • localhost - 支持
  • http://localhost/ - 支持
  • hostname.invaliddomain - 不支持
  • http://telewebica.local/ - 不支持

查看官方Microsoft FAQ

Microsoft在MSDN上有一个有用的FAQ,涵盖了许多常见问题。

Office 365目前不支持

目前Skype Web SDK不支持Skype for Business Online或Office 365账户。它只支持本地或托管环境。Microsoft已经表示Office 365将在路线图上支持Skype Web SDK,但尚未提供时间表。

跨域授权

如先决条件中所述,确保将要运行SDK的每个域(包括任何本地域)都已添加到跨域授权列表中。这可以使用Lync/Skype for Business Management Shell执行。

$myurl = New-CsWebOrigin -Url "{https://mysite}" Set-CsWebServiceConfiguration -Identity "{myid}" -CrossDomainAuthorizationList @{Add=$myurl}

如果不确定域是否已添加,可以使用Management Shell查询已授权域的列表。

Get-CsWebServiceConfiguration | select -ExpandProperty CrossDomainAuthorizationList

支持的浏览器

自然,确保和用户使用的是支持的Web浏览器是很重要的。Skype for Business Web App的兼容性表也适用于Web SDK。

使用浏览器控制台日志查看认证过程

所有现代浏览器都有一个控制台日志,显示JavaScript日志和错误。这是识别服务器错误以及基本JavaScript错误的强大工具。

Fiddler是朋友

Fiddler是Telerik公司提供的免费网络调试工具,比现代浏览器内置的控制台和调试工具更全面。使用Fiddler,可以捕获每个HTTP操作,包括请求和响应,以及完整的响应有效载荷,并检查错误和问题。

检查SSL证书

如果SDK代码托管在受SSL保护的网站上,请确保证书实际上是有效的!这听起来很明显,但很容易忽视。

无论是从网站提供jQuery,还是引用CDN上的托管版本,请确保引用保持最新。

与jQuery一样,Microsoft托管的Skype Web SDK也会不时更新。截至本文发布日期,当前版本是1.1.23。

<script src="https://swx.cdn.skype.com/shared/v/1.1.23.0/SkypeBootstrap.min.js"></script>
沪ICP备2024098111号-1
上海秋旦网络科技中心:上海市奉贤区金大公路8218号1幢 联系电话:17898875485