SharePoint 2013 App Development读书笔记2

    每一个App都有一个AppManifest.xml配置文件，这个文件包含了App的重要配置数据，例如App的Title，版本号，App开始页面（Start Page）的Url等等，当你使用VS2012创建一个App项目的时候，会自动生成如下的AppManifest.xml配置文件：

<App xmlns=http://schemas.microsoft.com/sharepoint/2012/app/manifest 
     Name=”MyTestApp” 
     ProductID=”{b19e4863-1939-4cf0-a73b-8dc07e7c09fa}” Version=”1.0.0.0” SharePointMinVersion=”15.0.0.0” > 

    <Properties> 
        <Title>MyTestApp</Title> 
        <StartPage>~appWebUrl/Pages/Default.aspx?{StandardTokens}</StartPage> 
    </Properties>

    <AppPrincipal>
        <Internal />
    </AppPrincipal>
</App>

        以下列表是一些常用的属性及用处：

属性	用途
Name	App的名字，也用作app web的相对路径（app web参见下面的说明）
ProductID	App的ID
Version	App的版本号
SharePointMinVersion	SharePoint的版本
Properties\Ttitle	App launcher的标题
Properties\StartPage	App开始页面的Url
Properties\SupportedLanguages	App支持的语言
Properties\WebTemplate	站点模版
Properties\InstalledEventEndpoint	在安装过程中执行的event receiver的Url
Properties\UpgradedEventEndpoint	在升级过程中执行的event receiver的Url
Properties\UninstalledEventEndpoint	在卸载过程中执行的event receiver的Url
AppPrincipal\Internal	不需要外部认证（SharePoint-hosted使用）
AppPrincipal\RemoteWebApplication	需要外部认证（provider-hosted使用）
AppPrincipal\AutoDeployedWebApplication	需要外部认证（auto-hosted使用）
AppPermissionRequests\AppPermissionRequest	在App安装过程中必须的权限
AppPrerequisites\AppPrerequisite	App正常运行需要的SharePoint services
RemoteEndpoints\RemoteEndpoint	跨域设置

以上属性都可以在VS中使用可视化界面配置。

    <StartPage>需要指定一个开始页面的url，在SharePoint hosted环境中，使用~appWebUrl占位符，例如

    ~appWebUrl/Pages/Default.aspx

    在Cloud hosted环境中，使用~remoteAppUrl占位符例如

    ~remoteAppUrl/Pages/Default.aspx

    以上占位符在debug的时候，VS会自动替换为App所在的web的url。但是在publish的时候，provider-hosted运行方式下有一个特点，就是ApManifest.xml是不能包含占位符的，必须指定一个remote web的url。

    可以在查询字符串中添加{StandardTokens}占位符，用来传递一些有用的信息例如：

    ~remoteAppUrl/Pages/Default.aspx?{StandardTokens}

    这里的{StandardTokens}占位符中包含两个参数，一个是SPHostUrl，一个是SPLanguage，因此会在运行时被替换成

    SPHostUrl=http%3A%2F%2Fwingtipserver&SPLanguage=en%2DUS

    

    App Web：这是App使用的一个特殊的web，这个web是SharePoint在安装App的时候，在site中创建的一个子站点，App对这个站点有所有的权限，可以在其中保存自己的数据，例如创建列表，文档库等等。这个app web会在App卸载的时候自动删除。如果你安装了一个App，在AppManifest.xml配置文件中的Name属性为“MyFirstApp”，那么SharePoint创建的app web的名字就是MyFirstApp，其相对路径是“/MyFirstApp”

    

SharePoint 2013 App Development读书笔记1

SharePoint 2013 App Development读书笔记3