目標(biāo)：做一個(gè)可以讀取 Xamarin.Android 所生成的 APK 的基本信息的 task ,包括 package（包名） / application label(應(yīng)用標(biāo)題 )/version name(版本號(hào))/version code(版本代碼)

下面簡(jiǎn)述流程

1.下載并安裝 Visual Studio Code（http://code.visualstudio.com )，當(dāng)然使用 Visual Studio 或者其它任何開(kāi)發(fā)工具也可以

2.下載并安裝最新版本 nodejs（https://nodejs.org）,如果是直接安裝的 vs 這些應(yīng)該直接都有了

3.建立自己的項(xiàng)目文件夾，如 d:\code\home

4.通過(guò) npm 安裝編譯工具 tfx-cli

npm i -g tfx-cli

5.在自己的項(xiàng)目文件夾中建立一個(gè) vss-extension.json 文件，這個(gè)文件中說(shuō)明了當(dāng)前擴(kuò)展包的信息，以及擴(kuò)展包中包含哪些任務(wù)

{
    "manifestVersion": 1,
    "id": "zou-tasks",
    "name": "Zou Tasks",
    "version": "1.0.4",
    "publisher": "zoujian",
    "targets": [
        {
            "id": "Microsoft.VisualStudio.Services"
        }
    ],
    "description": "Tools for building & publish",
    "categories": [
        "Build and release"
    ],
    "icons": {
        "default": "extension-icon.png"
    },
    "files": [
        {
            "path": "extract-xamarin-android-manifest"
        }
    ],
    "contributions": [
        {
            "id": "extract-xamarin-android-manifest",
            "type": "ms.vss-distributed-task.task",
            "targets": [
                "ms.vss-distributed-task.tasks"
            ],
            "properties": {
                "name": "extract-xamarin-android-manifest"
            }
        }
    ]
}

6.以上面擴(kuò)展信息中所示，擴(kuò)展包中包含了一個(gè)叫 extract-xamarin-android-manifest（我的任務(wù)）的插件，文件夾結(jié)構(gòu)是這樣的

extension-icon.png (vsix的圖標(biāo))
vss-extension.json

extract-xamarin-android-manifest
　　- extract.ps1 （任務(wù)的對(duì)應(yīng)腳本，是在task.json中配置的此名稱）
　　- icon.png （任務(wù)的圖標(biāo)）
　　- task.json （任務(wù)的配置文件）

其中 task.json 是最主要的文件，我當(dāng)前的這個(gè)擴(kuò)展是讀取 Xamarin.Android 的項(xiàng)目，并且讀取出生成 apk 的基礎(chǔ)信息，包含 application 的 label，packagename,version name,version code

{
  "id": "f1821fab-78d1-4c22-a0e4-f98f40fd7079",//任務(wù)的唯一id
  "name": "extract-xamarin-android-manifest",//任務(wù)名稱
  "friendlyName": "extract xamarin android info",//友好任務(wù)名
  "description": "extract xamarin android info",
  "author": "zoujian",
  "helpMarkDown": "[More Information](https://github.com/chsword/zou-vsts-tasks)",//幫助（就是顯示時(shí)后面的吧號(hào)）
  "category": "Utility",//類別，工具
  "visibility": [
    "Build",
    "Release"
  ],
  "demands": [
    "DotNetFramework"
  ],
  "version": {//版本
    "Major": "1",
    "Minor": "0",
    "Patch": "4"
  },
  "minimumAgentVersion": "1.83.0",//支持vso agent的版本
  "instanceNameFormat": "ExtractXamarinAndroidManifest",//實(shí)例名
  "groups": [//如果輸入?yún)?shù)要分組的話，建一個(gè)
    {
      "name": "output",
      "displayName": "Output",
      "isExpanded": true
    }
  ],
  "inputs": [//各種輸入?yún)?shù)
    {
      "name": "pathXamarinAndroidProject",
      "type": "filePath",
      "label": "Xamarin Android project Path",
      "defaultValue": "",
      "required": true,
      "helpMarkDown": "Path which Xamarin Android project exisis."
    },
    {
      "name": "configuration",
      "type": "string",
      "label": "Configuration",
      "defaultValue": "$(BuildConfiguration)",
      "required": true
    },
    {
      "name": "outputVariable",
      "type": "string",
      "label": "outputVariable",
      "required": true,
      "defaultValue": "android",
      "groupName": "output",
      "helpMarkDown": "Provide a name for the variable for the android info. eg. set the outputVariable 'android', after task running, will return 'android.PackageName','android.ApplicationLabel','android.VersionName','android.VersionCode'."
    }
  ],
  "execution": {//實(shí)際執(zhí)行的過(guò)程，我這里是執(zhí)行了一個(gè)powershell腳本，有興趣的同學(xué)可以看下，就是讀取了apk的AndroidManifest的xml結(jié)構(gòu)
    "PowerShell": {
      "target": "$(currentDirectory)\\extract.ps1",
      "argumentFormat": "",
      "workingDirectory": "$(currentDirectory)"
    }
  }
}

7.要編譯為VSIX的話，執(zhí)行 tfx extension create --manifest-globs vss-extension.json

8.tfs或vso中導(dǎo)入vsix，過(guò)程不說(shuō)述

9.可以直接在tfs中使用了

實(shí)際使用時(shí)，如此配置參數(shù)：