Support publishing package with xml files (Azure#19787) (Azure#20023)

* Publish package with xml files (Azure#19787)

* Refine codes

Author: BethanyZhou

build.proj

@@ -300,7 +300,7 @@
     <Exec Command="$(PowerShellCoreCommandPrefix) &quot;. $(RepoTools)/NewOutputTypeIndex.ps1 -OutputFile $(RepoArtifacts)/outputtypes.json -BuildConfig $(Configuration)&quot;"  Condition="'$(TargetModule)' == ''"/>
     <Exec Command="$(PowerShellCoreCommandPrefix) &quot;. $(RepoTools)/NewHelpIndex.ps1 -OutputFile $(RepoArtifacts)/index.json -BuildConfig $(Configuration)&quot;" Condition="'$(TargetModule)' == ''"/>
 
-    <Exec Command="$(PowerShellCoreCommandPrefix) &quot;. $(RepoTools)/CleanupBuild.ps1 -BuildConfig $(Configuration)&quot;" />
+    <Exec Command="$(PowerShellCoreCommandPrefix) &quot;. $(RepoTools)/CleanupBuild.ps1 -BuildConfig $(Configuration) -GenerateDocumentationFile $(GenerateDocumentationFile) &quot;" />
 
     <Error Condition="'$(NuGetKey)' == ''" Text="You must provide the NuGetKey parameter to the build: /p:NuGetKey=YOUR_PUBLISHING_KEY" />
     <Exec Command="$(PowerShellCoreCommandPrefix) &quot;. $(RepoTools)/PublishModules.ps1 -IsNetCore:$$(NetCore) -BuildConfig $(Configuration) -Scope $(Scope) -ApiKey $(NuGetKey) -RepositoryLocation \&quot;$(NuGetPublishingSource)\&quot;&quot; -NugetExe $(NuGetCommand)" />

tools/CleanupBuild.ps1

@@ -1,34 +1,61 @@
+# ----------------------------------------------------------------------------------
+# Copyright Microsoft Corporation
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+# http://www.apache.org/licenses/LICENSE-2.0
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+# ----------------------------------------------------------------------------------
+
+<#
+.SYNOPSIS
+    Clean up unrelated files before nuget publish
+
+.PARAMETER GenerateDocumentationFile
+    Decide whether keeps XML files
+#>
 [CmdletBinding()]
 Param
 (
     [Parameter()]
-    [string]$BuildConfig ="Debug"
+    [string]$BuildConfig ="Debug",
+    [Parameter()]
+    [string]$GenerateDocumentationFile ="false"
+
 )
 
 $output = Join-Path (Get-Item $PSScriptRoot).Parent.FullName "artifacts\$BuildConfig"
 Write-Verbose "The output folder is set to $output"
 $resourceManagerPath = $output
 
 $outputPaths = @($output)
+$resourcesFolders = @("de", "es", "fr", "it", "ja", "ko", "ru", "zh-Hans", "zh-Hant", "cs", "pl", "pt-BR", "tr")
+$keepItems = @("*.dll-Help.xml", "Scaffold.xml", "RoleSettings.xml", "WebRole.xml", "WorkerRole.xml")
+$removeItems = @("*.lastcodeanalysissucceeded", "*.dll.config", "*.pdb")
+if($GenerateDocumentationFile -eq "false"){
+    Write-Verbose "Removing *.xml files from $output"
+    $removeItems += "*.xml"
+}
+$webdependencies = @("Microsoft.Web.Hosting.dll", "Microsoft.Web.Delegation.dll", "Microsoft.Web.Administration.dll", "Microsoft.Web.Deployment.Tracing.dll")
 
 foreach ($path in $outputPaths)
 {
     Write-Verbose "Removing generated NuGet folders from $path"
-    $resourcesFolders = @("de", "es", "fr", "it", "ja", "ko", "ru", "zh-Hans", "zh-Hant", "cs", "pl", "pt-BR", "tr")
     Get-ChildItem -Include $resourcesFolders -Recurse -Force -Path $path | Remove-Item -Force -Recurse -ErrorAction SilentlyContinue
 
     Write-Verbose "Removing autogenerated XML help files, code analysis, config files, and symbols."
-    $exclude = @("*.dll-Help.xml", "Scaffold.xml", "RoleSettings.xml", "WebRole.xml", "WorkerRole.xml")
-    $include = @("*.xml", "*.lastcodeanalysissucceeded", "*.dll.config", "*.pdb")
-    Get-ChildItem -Include $include -Exclude $exclude -Recurse -Path $path | Remove-Item -Force -Recurse
+    Get-ChildItem -Include $removeItems -Exclude $keepItems -Recurse -Path $path | Remove-Item -Force -Recurse
     Get-ChildItem -Recurse -Path $path -Include *.dll-Help.psd1 | Remove-Item -Force
 
     Write-Verbose "Removing markdown help files and folders"
     Get-ChildItem -Recurse -Path $path -Include *.md | Remove-Item -Force -Confirm:$false
     Get-ChildItem -Directory -Include help -Recurse -Path $path | Remove-Item -Force -Recurse -Confirm:$false -ErrorAction "Ignore"
 
     Write-Verbose "Removing unneeded web deployment dependencies"
-    $webdependencies = @("Microsoft.Web.Hosting.dll", "Microsoft.Web.Delegation.dll", "Microsoft.Web.Administration.dll", "Microsoft.Web.Deployment.Tracing.dll")
     Get-ChildItem -Include $webdependencies -Recurse -Path $path | Remove-Item -Force
 }