mono
/
SkiaSharp
зеркало из https://github.com/mono/SkiaSharp.git
1
0
Форкнуть 0
Код Задачи Пакеты Проекты Релизы Вики Активность

Changing the way docs are generated... 

- using the frameworks mode
 - updated mdoc
 - moved the docs scripts into a new file as they are not part of the main script
This commit is contained in:
Matthew Leibowitz 2018-04-21 01:56:38 +02:00
Родитель 6b0badac73
Коммит bfbd358167
Не найден ключ, соответствующий данной подписи
Идентификатор ключа GPG: 3650EBE4AA155AF9
36 изменённых файлов: 258 добавлений и 155 удалений
Показать статистику Скачать Patch файл Скачать Diff файл Показать все файлы Свернуть все файлы

3
VERSIONS.txt
Просмотреть файл

@ -1,11 +1,12 @@
# dependencies
ANGLE release 2.1.13
7Zip4Powershell release 1.8.0
mdoc release 5.6.0
mdoc release 5.6.4
harfbuzz release 1.4.6
skia release m60
xunit.runner.console release 2.3.1
Xamarin.Forms release 2.5.0.280555
OpenTK.GLControl release 1.1.2349.61993
# native sonames
libSkiaSharp soname 60.1.0

2
binding/HarfBuzzSharp.Android/HarfBuzzSharp.Android.csproj
Просмотреть файл

@ -49,7 +49,7 @@
<Reference Include="Mono.Android" />
</ItemGroup>
<ItemGroup>
<PackageReference Include="mdoc" Version="5.6.0" PrivateAssets="All" />
<PackageReference Include="mdoc" Version="5.6.4" PrivateAssets="All" />
</ItemGroup>
<ItemGroup>
<Compile Include="Properties\AssemblyInfo.cs" />

2
binding/HarfBuzzSharp.Desktop/HarfBuzzSharp.Desktop.csproj
Просмотреть файл

@ -45,7 +45,7 @@
<Reference Include="System.Xml" />
</ItemGroup>
<ItemGroup>
<PackageReference Include="mdoc" Version="5.6.0" PrivateAssets="All" />
<PackageReference Include="mdoc" Version="5.6.4" PrivateAssets="All" />
</ItemGroup>
<ItemGroup>
<Compile Include="Properties\AssemblyInfo.cs" />

2
binding/HarfBuzzSharp.NetStandard/HarfBuzzSharp.NetStandard.csproj
Просмотреть файл

@ -10,7 +10,7 @@
<PackagingPlatform>netstandard1.3</PackagingPlatform>
</PropertyGroup>
<ItemGroup>
<PackageReference Include="mdoc" Version="5.6.0" PrivateAssets="All" />
<PackageReference Include="mdoc" Version="5.6.4" PrivateAssets="All" />
</ItemGroup>
<PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Debug|AnyCPU'">
<DefineConstants>TRACE;DEBUG;HARFBUZZ;NET_STANDARD</DefineConstants>

2
binding/HarfBuzzSharp.OSX/HarfBuzzSharp.OSX.csproj
Просмотреть файл

@ -55,7 +55,7 @@
<Reference Include="Xamarin.Mac" />
</ItemGroup>
<ItemGroup>
<PackageReference Include="mdoc" Version="5.6.0" PrivateAssets="All" />
<PackageReference Include="mdoc" Version="5.6.4" PrivateAssets="All" />
</ItemGroup>
<ItemGroup>
<Compile Include="Properties\AssemblyInfo.cs" />

2
binding/HarfBuzzSharp.UWP/HarfBuzzSharp.UWP.csproj
Просмотреть файл

@ -41,7 +41,7 @@
<WarningLevel>4</WarningLevel>
</PropertyGroup>
<ItemGroup>
<PackageReference Include="mdoc" Version="5.6.0" PrivateAssets="All" />
<PackageReference Include="mdoc" Version="5.6.4" PrivateAssets="All" />
<PackageReference Include="Microsoft.NETCore.UniversalWindowsPlatform" Version="6.0.6" />
</ItemGroup>
<ItemGroup>

2
binding/HarfBuzzSharp.iOS/HarfBuzzSharp.iOS.csproj
Просмотреть файл

@ -38,7 +38,7 @@
<Reference Include="Xamarin.iOS" />
</ItemGroup>
<ItemGroup>
<PackageReference Include="mdoc" Version="5.6.0" PrivateAssets="All" />
<PackageReference Include="mdoc" Version="5.6.4" PrivateAssets="All" />
</ItemGroup>
<ItemGroup>
<ObjcBindingApiDefinition Include="ApiDefinition.cs" />

2
binding/HarfBuzzSharp.tvOS/HarfBuzzSharp.tvOS.csproj
Просмотреть файл

@ -38,7 +38,7 @@
<Reference Include="Xamarin.TVOS" />
</ItemGroup>
<ItemGroup>
<PackageReference Include="mdoc" Version="5.6.0" PrivateAssets="All" />
<PackageReference Include="mdoc" Version="5.6.4" PrivateAssets="All" />
</ItemGroup>
<ItemGroup>
<Compile Include="Properties\AssemblyInfo.cs" />

2
binding/HarfBuzzSharp.watchOS/HarfBuzzSharp.watchOS.csproj
Просмотреть файл

@ -38,7 +38,7 @@
<Reference Include="Xamarin.WatchOS" />
</ItemGroup>
<ItemGroup>
<PackageReference Include="mdoc" Version="5.6.0" PrivateAssets="All" />
<PackageReference Include="mdoc" Version="5.6.4" PrivateAssets="All" />
</ItemGroup>
<ItemGroup>
<Compile Include="Properties\AssemblyInfo.cs" />

2
binding/SkiaSharp.Android/SkiaSharp.Android.csproj
Просмотреть файл

@ -48,7 +48,7 @@
<Reference Include="Mono.Android" />
</ItemGroup>
<ItemGroup>
<PackageReference Include="mdoc" Version="5.6.0" PrivateAssets="All" />
<PackageReference Include="mdoc" Version="5.6.4" PrivateAssets="All" />
</ItemGroup>
<ItemGroup>
<Compile Include="Properties\AssemblyInfo.cs" />

2
binding/SkiaSharp.Desktop/SkiaSharp.Desktop.csproj
Просмотреть файл

@ -49,7 +49,7 @@
<Reference Include="System.Xml" />
</ItemGroup>
<ItemGroup>
<PackageReference Include="mdoc" Version="5.6.0" PrivateAssets="All" />
<PackageReference Include="mdoc" Version="5.6.4" PrivateAssets="All" />
</ItemGroup>
<ItemGroup>
<Compile Include="Properties\AssemblyInfo.cs" />

2
binding/SkiaSharp.NetStandard/SkiaSharp.NetStandard.csproj
Просмотреть файл

@ -21,7 +21,7 @@
<OutputPath>bin\Release\</OutputPath>
</PropertyGroup>
<ItemGroup>
<PackageReference Include="mdoc" Version="5.6.0" PrivateAssets="All" />
<PackageReference Include="mdoc" Version="5.6.4" PrivateAssets="All" />
<PackageReference Include="System.IO.UnmanagedMemoryStream" Version="4.3.0" />
</ItemGroup>
<Import Project="..\Binding\Binding.projitems" Label="Shared" />

2
binding/SkiaSharp.OSX/SkiaSharp.OSX.csproj
Просмотреть файл

@ -57,7 +57,7 @@
<Reference Include="Xamarin.Mac" />
</ItemGroup>
<ItemGroup>
<PackageReference Include="mdoc" Version="5.6.0" PrivateAssets="All" />
<PackageReference Include="mdoc" Version="5.6.4" PrivateAssets="All" />
</ItemGroup>
<ItemGroup>
<Folder Include="Resources\" />

2
binding/SkiaSharp.UWP/SkiaSharp.UWP.csproj
Просмотреть файл

@ -43,7 +43,7 @@
<AllowUnsafeBlocks>true</AllowUnsafeBlocks>
</PropertyGroup>
<ItemGroup>
<PackageReference Include="mdoc" Version="5.6.0" PrivateAssets="All" />
<PackageReference Include="mdoc" Version="5.6.4" PrivateAssets="All" />
<PackageReference Include="Microsoft.NETCore.UniversalWindowsPlatform" Version="6.0.6" />
</ItemGroup>
<ItemGroup>

2
binding/SkiaSharp.iOS/SkiaSharp.iOS.csproj
Просмотреть файл

@ -41,7 +41,7 @@
<Reference Include="System.Core" />
</ItemGroup>
<ItemGroup>
<PackageReference Include="mdoc" Version="5.6.0" PrivateAssets="All" />
<PackageReference Include="mdoc" Version="5.6.4" PrivateAssets="All" />
</ItemGroup>
<ItemGroup>
<Folder Include="Resources\" />

2
binding/SkiaSharp.tvOS/SkiaSharp.tvOS.csproj
Просмотреть файл

@ -41,7 +41,7 @@
<Reference Include="System.Core" />
</ItemGroup>
<ItemGroup>
<PackageReference Include="mdoc" Version="5.6.0" PrivateAssets="All" />
<PackageReference Include="mdoc" Version="5.6.4" PrivateAssets="All" />
</ItemGroup>
<ItemGroup>
<Folder Include="Resources\" />

2
binding/SkiaSharp.watchOS/SkiaSharp.watchOS.csproj
Просмотреть файл

@ -41,7 +41,7 @@
<Reference Include="System.Core" />
</ItemGroup>
<ItemGroup>
<PackageReference Include="mdoc" Version="5.6.0" PrivateAssets="All" />
<PackageReference Include="mdoc" Version="5.6.4" PrivateAssets="All" />
</ItemGroup>
<ItemGroup>
<Folder Include="Resources\" />

127
build.cake
Просмотреть файл

@ -3,13 +3,17 @@
#addin nuget:?package=Cake.FileHelpers&version=2.0.0
#reference "tools/SharpCompress/lib/net45/SharpCompress.dll"
#reference "tools/Newtonsoft.Json/lib/net45/Newtonsoft.Json.dll"
using System.Linq;
using System.Net.Http;
using System.Runtime.InteropServices;
using System.Text.RegularExpressions;
using System.Xml;
using System.Xml.Linq;
using SharpCompress.Readers;
using Newtonsoft.Json;
using Newtonsoft.Json.Linq;
#load "cake/Utils.cake"
@ -55,6 +59,7 @@ if (string.IsNullOrEmpty (BUILD_NUMBER)) {
#load "cake/UtilsManaged.cake"
#load "cake/BuildExternals.cake"
#load "cake/UpdateDocs.cake"
////////////////////////////////////////////////////////////////////////////////////////////////////
// EXTERNALS - the native C and C++ libraries
@ -261,128 +266,6 @@ Task ("samples")
}
});
////////////////////////////////////////////////////////////////////////////////////////////////////
// DOCS - building the API documentation
////////////////////////////////////////////////////////////////////////////////////////////////////
Task ("update-docs")
.Does (() =>
{
// the reference folders to locate assemblies
var refs = new List<DirectoryPath> ();
if (IsRunningOnWindows ()) {
var refAssemblies = "C:/Program Files (x86)/Microsoft Visual Studio/*/*/Common7/IDE/ReferenceAssemblies/Microsoft/Framework";
refs.AddRange (GetDirectories ($"{refAssemblies}/MonoAndroid/v1.0"));
refs.AddRange (GetDirectories ($"{refAssemblies}/MonoAndroid/v4.0.3"));
refs.AddRange (GetDirectories ($"{refAssemblies}/Xamarin.iOS/v1.0"));
refs.AddRange (GetDirectories ($"{refAssemblies}/Xamarin.TVOS/v1.0"));
refs.AddRange (GetDirectories ($"{refAssemblies}/Xamarin.WatchOS/v1.0"));
refs.AddRange (GetDirectories ($"{refAssemblies}/Xamarin.Mac/v2.0"));
refs.AddRange (GetDirectories ("C:/Program Files (x86)/Windows Kits/10/References/Windows.Foundation.UniversalApiContract/1.0.0.0"));
refs.AddRange (GetDirectories ($"{NUGET_PACKAGES}/xamarin.forms/{GetVersion ("Xamarin.Forms", "release")}/lib/*"));
}
// the assemblies to generate docs for
var assemblies = new FilePath [] {
// SkiaSharp
"./output/SkiaSharp/nuget/lib/netstandard1.3/SkiaSharp.dll",
// SkiaSharp.Views
"./output/SkiaSharp.Views/nuget/lib/MonoAndroid/SkiaSharp.Views.Android.dll",
"./output/SkiaSharp.Views/nuget/lib/net45/SkiaSharp.Views.Desktop.dll",
"./output/SkiaSharp.Views/nuget/lib/net45/SkiaSharp.Views.Gtk.dll",
"./output/SkiaSharp.Views/nuget/lib/net45/SkiaSharp.Views.WPF.dll",
"./output/SkiaSharp.Views/nuget/lib/Xamarin.iOS/SkiaSharp.Views.iOS.dll",
"./output/SkiaSharp.Views/nuget/lib/Xamarin.Mac20/SkiaSharp.Views.Mac.dll",
"./output/SkiaSharp.Views/nuget/lib/Xamarin.TVOS/SkiaSharp.Views.tvOS.dll",
"./output/SkiaSharp.Views/nuget/lib/uap10.0/SkiaSharp.Views.UWP.dll",
"./output/SkiaSharp.Views/nuget/lib/Xamarin.WatchOS/SkiaSharp.Views.watchOS.dll",
// SkiaSharp.Views.Forms
"./output/SkiaSharp.Views.Forms/nuget/lib/netstandard1.3/SkiaSharp.Views.Forms.dll",
// HarfBuzzSharp
"./output/HarfBuzzSharp/nuget/lib/netstandard1.3/HarfBuzzSharp.dll",
// SkiaSharp.HarfBuzz
"./output/SkiaSharp.HarfBuzz/nuget/lib/netstandard1.3/SkiaSharp.HarfBuzz.dll",
};
// print out the assemblies
foreach (var r in refs) {
Information ("Reference Directory: {0}", r);
}
foreach (var a in assemblies) {
Information ("Assemblies {0}...", a);
}
// generate doc files
var refArgs = string.Join (" ", refs.Select (r => $"--lib=\"{r}\""));
var assemblyArgs = string.Join (" ", assemblies.Select (a => $"\"{a}\""));
RunProcess (MDocPath, new ProcessSettings {
Arguments = $"update --preserve --out=\"{DOCS_PATH}\" {refArgs} {assemblyArgs}",
});
// process the generated docs
var docFiles = GetFiles ("./docs/**/*.xml");
float typeCount = 0;
float memberCount = 0;
float totalTypes = 0;
float totalMembers = 0;
foreach (var file in docFiles) {
var xdoc = XDocument.Load (file.ToString ());
// remove IComponent docs as this is just designer
xdoc.Root
.Elements ("Members")
.Elements ("Member")
.Where (e => e.Attribute ("MemberName")?.Value?.StartsWith ("System.ComponentModel.IComponent.") == true)
.Remove ();
// count the types without docs
var typesWithDocs = xdoc.Root
.Elements ("Docs");
totalTypes += typesWithDocs.Count ();
var currentTypeCount = typesWithDocs.Count (m => m.Value?.IndexOf ("To be added.") >= 0);
typeCount += currentTypeCount;
// count the members without docs
var membersWithDocs = xdoc.Root
.Elements ("Members")
.Elements ("Member")
.Where (m => m.Attribute ("MemberName")?.Value != "Dispose" && m.Attribute ("MemberName")?.Value != "Finalize")
.Elements ("Docs");
totalMembers += membersWithDocs.Count ();
var currentMemberCount = membersWithDocs.Count (m => m.Value?.IndexOf ("To be added.") >= 0);
memberCount += currentMemberCount;
// log if either type or member has missing docs
currentMemberCount += currentTypeCount;
if (currentMemberCount > 0) {
var fullName = xdoc.Root.Attribute ("FullName");
if (fullName != null)
Information ("Docs missing on {0} = {1}", fullName.Value, currentMemberCount);
}
// get the whitespaces right
var settings = new XmlWriterSettings {
Encoding = new UTF8Encoding (),
Indent = true,
NewLineChars = "\n",
OmitXmlDeclaration = true,
};
using (var writer = XmlWriter.Create (file.ToString (), settings)) {
xdoc.Save (writer);
writer.Flush ();
}
// empty line at the end
System.IO.File.AppendAllText (file.ToString (), "\n");
}
// log summary
Information (
"Documentation missing in {0}/{1} ({2:0.0%}) types and {3}/{4} ({5:0.0%}) members.",
typeCount, totalTypes, typeCount / totalTypes,
memberCount, totalMembers, memberCount / totalMembers);
});
////////////////////////////////////////////////////////////////////////////////////////////////////
// NUGET - building the package for NuGet.org
////////////////////////////////////////////////////////////////////////////////////////////////////

3
cake.packages.config
Просмотреть файл

@ -2,6 +2,7 @@
<packages>
<package id="Cake" version="0.26.1" />
<package id="xunit.runner.console" version="2.3.1" />
<package id="mdoc" version="5.6.0" />
<package id="mdoc" version="5.6.4" />
<package id="SharpCompress" version="0.18.1" />
<package id="Newtonsoft.Json" version="11.0.2" />
</packages>

217
cake/UpdateDocs.cake Normal file
Просмотреть файл

@ -0,0 +1,217 @@
void CreateFrameworks (Version minVersion, DirectoryPath docsTempPath) {
// download all the versions from nuget so we can generate the docs
var ids = new [] {
"skiasharp",
"skiasharp.views",
"skiasharp.views.forms",
"harfbuzzsharp",
"skiasharp.harfbuzz",
};
var xplat = new [] {
"netstandard1.3",
"portable-net45%2Bwin8%2Bwpa81%2Bwp8",
"portable-net45%2Bxamarinmac%2Bxamarinios%2Bmonotouch%2Bmonoandroid%2Bwin8%2Bwpa81%2Bwp8%2Bxamarin.watchos%2Bxamarin.tvos",
};
var metadata = "https://api.nuget.org/v3/registration3/{0}/index.json";
var download = "https://api.nuget.org/v3-flatcontainer/{0}/{1}/{0}.{1}.nupkg";
var packagesPath = MakeAbsolute (ROOT_PATH.Combine ("externals/docs_packages"));
// prepare the temp folder
EnsureDirectoryExists (docsTempPath);
CleanDirectories (docsTempPath.FullPath);
var xFrameworks = new XElement ("Frameworks");
var xFrameworksDoc = new XDocument (xFrameworks);
foreach (var id in ids) {
// get the versions for each nuget
Information ($"Downloading information for ID: {id}...");
var md = string.Format (metadata, id);
var mdFile = DownloadFile (md);
var mdObj = JObject.Parse (FileReadText (mdFile));
var page = mdObj ["items"] [0];
foreach (var package in page ["items"]) {
var version = (string) package ["catalogEntry"] ["version"];
// skip pre-release versions
if (version.Contains("-") || Version.Parse (version) < minVersion)
continue;
// download the assemblies
Information ($"Downloading '{id}' version '{version}'...");
var dest = packagesPath.Combine (id).Combine (version);
var destFile = dest.CombineWithFilePath ($"{id}.{version}.nupkg");
if (!FileExists (destFile)) {
EnsureDirectoryExists (dest);
DownloadFile (string.Format (download, id, version), destFile);
Unzip (destFile, dest);
}
// copy the assemblies into the temp folder
if (id == "skiasharp.views") {
// copy platform-specific
foreach (var dir in GetDirectories ($"{dest}/lib/*")) {
var d = dir.GetDirectoryName ().ToLower ();
var platform = "";
if (d.StartsWith ("monoandroid")) {
platform = "android";
} else if (d.StartsWith ("net4")) {
platform = "net";
} else if (d.StartsWith ("uap")) {
platform = "uwp";
} else if (d.StartsWith ("xamarinios")) {
platform = "ios";
} else if (d.StartsWith ("xamarinmac")) {
platform = "macos";
} else if (d.StartsWith ("xamarintvos")) {
platform = "tvos";
} else if (d.StartsWith ("xamarinwatchos")) {
platform = "watchos";
} else {
throw new Exception ($"Unknown platform: {d}");
}
var moniker = $"{id.Replace (".", "-")}-{platform}-{version}";
var o = docsTempPath.Combine (moniker);
EnsureDirectoryExists (o);
foreach (var f in GetFiles ($"{dir}/*.dll")) {
CopyFileToDirectory (f, o);
}
xFrameworks.Add (
new XElement ("Framework",
new XAttribute ("Name", o.GetDirectoryName ()),
new XAttribute ("Source", o.GetDirectoryName ())));
}
} else {
// copy netstandard/portable
var moniker = $"{id.Replace (".", "-")}-{version}";
var o = docsTempPath.Combine (moniker);
EnsureDirectoryExists (o);
foreach (var x in xplat) {
if (DirectoryExists ($"{dest}/lib/{x}")) {
foreach (var f in GetFiles ($"{dest}/lib/{x}/*.dll")) {
CopyFileToDirectory (f, o);
}
break;
}
}
xFrameworks.Add (
new XElement ("Framework",
new XAttribute ("Name", o.GetDirectoryName ()),
new XAttribute ("Source", o.GetDirectoryName ())));
}
}
}
xFrameworksDoc.Save ($"{docsTempPath}/frameworks.xml");
}
void FormatDocs ()
{
// process the generated docs
var docFiles = GetFiles ("./docs/**/*.xml");
float typeCount = 0;
float memberCount = 0;
float totalTypes = 0;
float totalMembers = 0;
foreach (var file in docFiles) {
var xdoc = XDocument.Load (file.ToString ());
// remove IComponent docs as this is just designer
xdoc.Root
.Elements ("Members")
.Elements ("Member")
.Where (e => e.Attribute ("MemberName")?.Value?.StartsWith ("System.ComponentModel.IComponent.") == true)
.Remove ();
// count the types without docs
var typesWithDocs = xdoc.Root
.Elements ("Docs");
totalTypes += typesWithDocs.Count ();
var currentTypeCount = typesWithDocs.Count (m => m.Value?.IndexOf ("To be added.") >= 0);
typeCount += currentTypeCount;
// count the members without docs
var membersWithDocs = xdoc.Root
.Elements ("Members")
.Elements ("Member")
.Where (m => m.Attribute ("MemberName")?.Value != "Dispose" && m.Attribute ("MemberName")?.Value != "Finalize")
.Elements ("Docs");
totalMembers += membersWithDocs.Count ();
var currentMemberCount = membersWithDocs.Count (m => m.Value?.IndexOf ("To be added.") >= 0);
memberCount += currentMemberCount;
// log if either type or member has missing docs
currentMemberCount += currentTypeCount;
if (currentMemberCount > 0) {
var fullName = xdoc.Root.Attribute ("FullName");
if (fullName != null)
Information ("Docs missing on {0} = {1}", fullName.Value, currentMemberCount);
}
// get the whitespaces right
var settings = new XmlWriterSettings {
Encoding = new UTF8Encoding (),
Indent = true,
NewLineChars = "\n",
OmitXmlDeclaration = true,
};
using (var writer = XmlWriter.Create (file.ToString (), settings)) {
xdoc.Save (writer);
writer.Flush ();
}
// empty line at the end
System.IO.File.AppendAllText (file.ToString (), "\n");
}
// log summary
Information (
"Documentation missing in {0}/{1} ({2:0.0%}) types and {3}/{4} ({5:0.0%}) members.",
typeCount, totalTypes, typeCount / totalTypes,
memberCount, totalMembers, memberCount / totalMembers);
}
Task ("format-docs")
.Does (() =>
{
FormatDocs ();
});
Task ("update-docs")
.Does (() =>
{
var docsTempPath = MakeAbsolute (ROOT_PATH.Combine ("output/docs/temp"));
// create the frameworks folder from the released NuGets
CreateFrameworks (new Version (1, 0, 0), docsTempPath);
// the reference folders to locate assemblies
var refs = new List<DirectoryPath> ();
if (IsRunningOnWindows ()) {
var refAssemblies = "C:/Program Files (x86)/Microsoft Visual Studio/*/*/Common7/IDE/ReferenceAssemblies/Microsoft/Framework";
refs.AddRange (GetDirectories ($"{refAssemblies}/MonoAndroid/v1.0"));
refs.AddRange (GetDirectories ($"{refAssemblies}/MonoAndroid/v4.0.3"));
refs.AddRange (GetDirectories ($"{refAssemblies}/Xamarin.iOS/v1.0"));
refs.AddRange (GetDirectories ($"{refAssemblies}/Xamarin.TVOS/v1.0"));
refs.AddRange (GetDirectories ($"{refAssemblies}/Xamarin.WatchOS/v1.0"));
refs.AddRange (GetDirectories ($"{refAssemblies}/Xamarin.Mac/v2.0"));
refs.AddRange (GetDirectories ("C:/Program Files (x86)/Windows Kits/10/References/Windows.Foundation.UniversalApiContract/1.0.0.0"));
refs.AddRange (GetDirectories ($"{NUGET_PACKAGES}/xamarin.forms/{GetVersion ("Xamarin.Forms", "release")}/lib/*"));
refs.AddRange (GetDirectories ($"{NUGET_PACKAGES}/tizen.net/{GetVersion ("Tizen.NET", "release")}/lib/*"));
refs.AddRange (GetDirectories ($"{NUGET_PACKAGES}/opentk.glcontrol/{GetVersion ("OpenTK.GLControl", "release")}/lib/*"));
}
// generate doc files
var refArgs = string.Join (" ", refs.Select (r => $"--lib=\"{r}\""));
var fw = MakeAbsolute (docsTempPath.CombineWithFilePath ("frameworks.xml"));
RunProcess (MDocPath, new ProcessSettings {
Arguments = $"update --preserve --out=\"{DOCS_PATH}\" -lang=DocId --frameworks={fw} {refArgs}",
WorkingDirectory = docsTempPath
});
// clean up after working
CleanDirectories (docsTempPath.FullPath);
FormatDocs ();
});

1
externals/.gitignore поставляемый
Просмотреть файл

@ -1,3 +1,4 @@
angle/
harfbuzz/
packages/
docs_packages/

2
source/SkiaSharp.HarfBuzz/SkiaSharp.HarfBuzz/SkiaSharp.HarfBuzz.csproj
Просмотреть файл

@ -11,7 +11,7 @@
<PackagingPlatform>netstandard1.3</PackagingPlatform>
</PropertyGroup>
<ItemGroup>
<PackageReference Include="mdoc" Version="5.6.0" PrivateAssets="All" />
<PackageReference Include="mdoc" Version="5.6.4" PrivateAssets="All" />
</ItemGroup>
<PropertyGroup Condition=" '$(Configuration)|$(Platform)' == 'Debug|AnyCPU' ">
<DefineConstants>TRACE;DEBUG;NET_STANDARD</DefineConstants>

2
source/SkiaSharp.Views.Forms/SkiaSharp.Views.Forms.Android/SkiaSharp.Views.Forms.Android.csproj
Просмотреть файл

@ -46,7 +46,7 @@
<Reference Include="Mono.Android" />
</ItemGroup>
<ItemGroup>
<PackageReference Include="mdoc" Version="5.6.0" PrivateAssets="All" />
<PackageReference Include="mdoc" Version="5.6.4" PrivateAssets="All" />
<PackageReference Include="Xamarin.Forms" Version="2.5.0.280555" />
</ItemGroup>
<ItemGroup>

2
source/SkiaSharp.Views.Forms/SkiaSharp.Views.Forms.Mac/SkiaSharp.Views.Forms.Mac.csproj
Просмотреть файл

@ -54,7 +54,7 @@
<Reference Include="Xamarin.Mac" />
</ItemGroup>
<ItemGroup>
<PackageReference Include="mdoc" Version="5.6.0" PrivateAssets="All" />
<PackageReference Include="mdoc" Version="5.6.4" PrivateAssets="All" />
<PackageReference Include="Xamarin.Forms" Version="2.5.0.280555" />
</ItemGroup>
<ItemGroup>

2
source/SkiaSharp.Views.Forms/SkiaSharp.Views.Forms.UWP/SkiaSharp.Views.Forms.UWP.csproj
Просмотреть файл

@ -42,7 +42,7 @@
<WarningLevel>4</WarningLevel>
</PropertyGroup>
<ItemGroup>
<PackageReference Include="mdoc" Version="5.6.0" PrivateAssets="All" />
<PackageReference Include="mdoc" Version="5.6.4" PrivateAssets="All" />
<PackageReference Include="Microsoft.NETCore.UniversalWindowsPlatform" Version="6.0.6" />
<PackageReference Include="Xamarin.Forms" Version="2.5.0.280555" />
</ItemGroup>

2
source/SkiaSharp.Views.Forms/SkiaSharp.Views.Forms.iOS/SkiaSharp.Views.Forms.iOS.csproj
Просмотреть файл

@ -52,7 +52,7 @@
<Reference Include="Xamarin.iOS" />
</ItemGroup>
<ItemGroup>
<PackageReference Include="mdoc" Version="5.6.0" PrivateAssets="All" />
<PackageReference Include="mdoc" Version="5.6.4" PrivateAssets="All" />
<PackageReference Include="Xamarin.Forms" Version="2.5.0.280555" />
</ItemGroup>
<ItemGroup>

2
source/SkiaSharp.Views.Forms/SkiaSharp.Views.Forms/SkiaSharp.Views.Forms.csproj
Просмотреть файл

@ -19,7 +19,7 @@
<OutputPath>bin\Release\</OutputPath>
</PropertyGroup>
<ItemGroup>
<PackageReference Include="mdoc" Version="5.6.0" PrivateAssets="All" />
<PackageReference Include="mdoc" Version="5.6.4" PrivateAssets="All" />
<PackageReference Include="Xamarin.Forms" Version="2.5.0.280555" />
</ItemGroup>
<ItemGroup>

2
source/SkiaSharp.Views/SkiaSharp.Views.Android/SkiaSharp.Views.Android.csproj
Просмотреть файл

@ -45,7 +45,7 @@
<Reference Include="Mono.Android" />
</ItemGroup>
<ItemGroup>
<PackageReference Include="mdoc" Version="5.6.0" PrivateAssets="All" />
<PackageReference Include="mdoc" Version="5.6.4" PrivateAssets="All" />
</ItemGroup>
<ItemGroup>
<Compile Include="AndroidExtensions.cs" />

2
source/SkiaSharp.Views/SkiaSharp.Views.Desktop/SkiaSharp.Views.Desktop.csproj
Просмотреть файл

@ -42,7 +42,7 @@
<Reference Include="Microsoft.CSharp" />
</ItemGroup>
<ItemGroup>
<PackageReference Include="mdoc" Version="5.6.0" PrivateAssets="All" />
<PackageReference Include="mdoc" Version="5.6.4" PrivateAssets="All" />
<PackageReference Include="OpenTK" Version="1.1.2349.61993" />
<PackageReference Include="OpenTK.GLControl" Version="1.1.2349.61993" />
</ItemGroup>

2
source/SkiaSharp.Views/SkiaSharp.Views.Gtk/SkiaSharp.Views.Gtk.csproj
Просмотреть файл

@ -41,7 +41,7 @@
<Reference Include="atk-sharp, Version=2.12.0.0, Culture=neutral, PublicKeyToken=35e10195dab3c99f" />
</ItemGroup>
<ItemGroup>
<PackageReference Include="mdoc" Version="5.6.0" PrivateAssets="All" />
<PackageReference Include="mdoc" Version="5.6.4" PrivateAssets="All" />
</ItemGroup>
<ItemGroup>
<ProjectReference Include="..\..\..\binding\SkiaSharp.Desktop\SkiaSharp.Desktop.csproj">

2
source/SkiaSharp.Views/SkiaSharp.Views.Mac/SkiaSharp.Views.Mac.csproj
Просмотреть файл

@ -59,7 +59,7 @@
<Reference Include="Xamarin.Mac" />
</ItemGroup>
<ItemGroup>
<PackageReference Include="mdoc" Version="5.6.0" PrivateAssets="All" />
<PackageReference Include="mdoc" Version="5.6.4" PrivateAssets="All" />
</ItemGroup>
<ItemGroup>
<Compile Include="MacExtensions.cs" />

2
source/SkiaSharp.Views/SkiaSharp.Views.UWP/SkiaSharp.Views.UWP.csproj
Просмотреть файл

@ -41,7 +41,7 @@
<WarningLevel>4</WarningLevel>
</PropertyGroup>
<ItemGroup>
<PackageReference Include="mdoc" Version="5.6.0" PrivateAssets="All" />
<PackageReference Include="mdoc" Version="5.6.4" PrivateAssets="All" />
<PackageReference Include="Microsoft.NETCore.UniversalWindowsPlatform" Version="6.0.6" />
</ItemGroup>
<ItemGroup>

2
source/SkiaSharp.Views/SkiaSharp.Views.WPF/SkiaSharp.Views.WPF.csproj
Просмотреть файл

@ -47,7 +47,7 @@
<Reference Include="PresentationFramework" />
</ItemGroup>
<ItemGroup>
<PackageReference Include="mdoc" Version="5.6.0" PrivateAssets="All" />
<PackageReference Include="mdoc" Version="5.6.4" PrivateAssets="All" />
</ItemGroup>
<ItemGroup>
<AppDesigner Include="Properties\" />

2
source/SkiaSharp.Views/SkiaSharp.Views.iOS/SkiaSharp.Views.iOS.csproj
Просмотреть файл

@ -45,7 +45,7 @@
<Reference Include="Xamarin.iOS" />
</ItemGroup>
<ItemGroup>
<PackageReference Include="mdoc" Version="5.6.0" PrivateAssets="All" />
<PackageReference Include="mdoc" Version="5.6.4" PrivateAssets="All" />
</ItemGroup>
<ItemGroup>
<Folder Include="Properties\" />

2
source/SkiaSharp.Views/SkiaSharp.Views.tvOS/SkiaSharp.Views.tvOS.csproj
Просмотреть файл

@ -44,7 +44,7 @@
<Reference Include="Xamarin.TVOS" />
</ItemGroup>
<ItemGroup>
<PackageReference Include="mdoc" Version="5.6.0" PrivateAssets="All" />
<PackageReference Include="mdoc" Version="5.6.4" PrivateAssets="All" />
</ItemGroup>
<ItemGroup>
<Folder Include="Properties\" />

2
source/SkiaSharp.Views/SkiaSharp.Views.watchOS/SkiaSharp.Views.watchOS.csproj
Просмотреть файл

@ -44,7 +44,7 @@
<Reference Include="Xamarin.WatchOS" />
</ItemGroup>
<ItemGroup>
<PackageReference Include="mdoc" Version="5.6.0" PrivateAssets="All" />
<PackageReference Include="mdoc" Version="5.6.4" PrivateAssets="All" />
</ItemGroup>
<ItemGroup>
<Folder Include="Properties\" />