[OneLoc] Localize Microsoft.Android.Templates (#7248)

Context: https://github.com/dotnet/templating/blob/6ecea73aad1ce3444dbf28fc340e5f464f6278df/docs/Localization.md

The `dotnet new` template engine supports localization as of .NET 6.

Update the `Microsoft.Android.Templates` project to use the new
localization system.  Local template builds now use
`Microsoft.TemplateEngine.Tasks` to generate the
`templatestrings.*.json` files used for localization.

The new `update-locproject.ps1` script runs as part of the
`OneLocBuild` job in CI (fa9629d).  This script will copy each
english `templatestrings.en.json` file to `templatestrings.json`, and
add it as a new translation source file entry to `LocProject.json`.
This update to `LocProject.json` will tell the `OneLocBuild` task to
process our templates.

This script borrows heavily from the [generate-locproject.ps1][0]
script found in dotnet/arcade.

Every time there is a change to one of the templates:

 1. The dev making the change should build the modified template
    project. This will update the loc files on the local working copy,

        dotnet build src/Microsoft.Android.Templates/Microsoft.Android.Templates.csproj
        # -or-
        dotnet build Xamarin.Android.sln

 2. Push the loc files together with the template modifications.
    Review & merge.

 3. OneLocBuild integration will automatically pick up the changes
    and will send them for translation.

 4. You will receive a PR containing the translated template loc
    files when they are ready. Review & merge.

[0]: https://github.com/dotnet/arcade/blob/e771d68edea1cfcd4a49e160093a4f32df8a6288/eng/common/generate-locproject.ps1

Author: pjcollins

Documentation/workflow/Localization.md

@@ -12,7 +12,7 @@
           "CopyOption": "LangIDOnName",
           "SourceFile": ".\\src\\Xamarin.Android.Build.Tasks\\Properties\\Resources.resx",
           "OutputPath": ".\\src\\Xamarin.Android.Build.Tasks\\Properties\\"
-        },
+        }
       ]
     }
   ]

Localize/LocProject.json

@@ -0,0 +1,28 @@
+param ($SourcesDirectory, $LocProjectPath)
+
+$jsonFiles = @()
+$jsonTemplateFiles = Get-ChildItem -Recurse -Path "$SourcesDirectory" | Where-Object { $_.FullName -Match "\.template\.config\\localize\\.+\.en\.json" } # .NET templating pattern
+$jsonTemplateFiles | ForEach-Object {
+    $null = $_.Name -Match "(.+)\.[\w-]+\.json" # matches '[filename].[langcode].json
+
+    $destinationFile = "$($_.Directory.FullName)\$($Matches.1).json"
+    $jsonFiles += Copy-Item "$($_.FullName)" -Destination $destinationFile -PassThru
+    Write-Host "Template loc file generated: $destinationFile"
+}
+
+Push-Location "$SourcesDirectory"
+$projectObject = Get-Content $LocProjectPath | ConvertFrom-Json
+$jsonFiles | ForEach-Object {
+    $sourceFile = ($_.FullName | Resolve-Path -Relative)
+    $outputPath = "$(($_.DirectoryName | Resolve-Path -Relative) + "\")"
+    $projectObject.Projects[0].LocItems += (@{
+        SourceFile = $sourceFile
+        CopyOption = "LangIDOnName"
+        OutputPath = $outputPath
+    })
+}
+Pop-Location
+
+$locProjectJson = ConvertTo-Json $projectObject -Depth 5
+Set-Content $LocProjectPath $locProjectJson
+Write-Host "LocProject.json was updated to contain template localizations:`n`n$locProjectJson`n`n" 

Localize/update-locproject.ps1

@@ -1880,7 +1880,7 @@ stages:
   # Check - "Xamarin.Android (Tenets OneLocBuild)"
   - job: OneLocBuild
     displayName: OneLocBuild
-    condition: eq(variables['MicroBuildSignType'], 'Real')
+    condition: and(eq(variables['MicroBuildSignType'], 'Real'), eq(variables['Build.SourceBranch'], 'refs/heads/main'))
     pool: VSEngSS-MicroBuild2022-1ES
     timeoutInMinutes: 30
     variables:
@@ -1891,6 +1891,13 @@ stages:
     - checkout: self
       clean: true
 
+    - task: PowerShell@2
+      displayName: Update LocProject.json
+      inputs:
+        targetType: filePath
+        filePath: $(Build.SourcesDirectory)\Localize\update-locproject.ps1
+        arguments: -SourcesDirectory "$(Build.SourcesDirectory)" -LocProjectPath "$(Build.SourcesDirectory)\Localize\LocProject.json"
+
     - task: OneLocBuild@2
       displayName: OneLocBuild
       env:

build-tools/automation/azure-pipelines.yaml

@@ -26,5 +26,9 @@
       <Uri>https://github.com/dotnet/arcade</Uri>
       <Sha>70831f0d126fe88b81d7dc8de11358e17a5ce364</Sha>
     </Dependency>
+    <Dependency Name="Microsoft.TemplateEngine.Tasks" Version="7.0.100-rc.1.22410.7">
+      <Uri>https://github.com/dotnet/templating</Uri>
+      <Sha>66ccf71bc4f0ba64f66b1674803e9999cd8111c8</Sha>
+    </Dependency>
   </ToolsetDependencies>
 </Dependencies>

eng/Version.Details.xml

@@ -8,6 +8,7 @@
     <MicrosoftDotNetBuildTasksFeedPackageVersion>7.0.0-beta.22103.1</MicrosoftDotNetBuildTasksFeedPackageVersion>
     <MicrosoftNETWorkloadEmscriptenManifest70100Version>7.0.0-rc.1.22368.1</MicrosoftNETWorkloadEmscriptenManifest70100Version>
     <MicrosoftNETWorkloadEmscriptenPackageVersion>$(MicrosoftNETWorkloadEmscriptenManifest70100Version)</MicrosoftNETWorkloadEmscriptenPackageVersion>
+    <MicrosoftTemplateEngineTasksPackageVersion>7.0.100-rc.1.22410.7</MicrosoftTemplateEngineTasksPackageVersion>
   </PropertyGroup>
   <PropertyGroup>
     <!-- Match the first three version numbers and append 00 -->

eng/Versions.props

@@ -0,0 +1 @@
+templatestrings.json

src/Microsoft.Android.Templates/.gitignore

@@ -8,6 +8,7 @@
     <Description>Templates for Android platforms.</Description>
     <IncludeContentInPack>true</IncludeContentInPack>
     <IncludeBuildOutput>false</IncludeBuildOutput>
+    <LocalizeTemplates Condition=" '$(RunningOnCI)' != 'true' ">true</LocalizeTemplates>
     <ContentTargetFolders>content</ContentTargetFolders>
     <OutputPath>..\..\bin\Build$(Configuration)\nuget-unsigned\</OutputPath>
     <!-- Remove the `<group targetFramework=".NETStandard2.0" />` entry from the .nuspec. -->
@@ -22,4 +23,8 @@
     <Compile Remove="**\*" />
   </ItemGroup>
 
+  <ItemGroup Condition=" '$(RunningOnCI)' != 'true' ">
+    <PackageReference Include="Microsoft.TemplateEngine.Tasks" Version="$(MicrosoftTemplateEngineTasksPackageVersion)" PrivateAssets="all" IsImplicitlyDefined="true" />
+  </ItemGroup>
+
 </Project>

src/Microsoft.Android.Templates/Microsoft.Android.Templates.csproj

@@ -0,0 +1,6 @@
+{
+  "author": "Microsoft",
+  "name": "Android Activity template",
+  "description": "An Android Activity class",
+  "symbols/namespace/description": "namespace for the generated code"
+}

src/Microsoft.Android.Templates/android-activity/.template.config/localize/templatestrings.cs.json

@@ -0,0 +1,6 @@
+{
+  "author": "Microsoft",
+  "name": "Android Activity template",
+  "description": "An Android Activity class",
+  "symbols/namespace/description": "namespace for the generated code"
+}