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

你可能感兴趣的:(SharePoint 2013 App Development读书笔记2)