如何創建 Xamarin PDF 生成器

為什麼伺服器端方法適用於 Xamarin PDF 生成

IronPDF 擅長根據 HTML 內容建立 PDF 文檔，並完全支援 CSS、JavaScript 和高級佈局功能。 在伺服器上運行它可以讓您的 Xamarin.Forms 應用程式發送 HTML 內容並接收完全渲染的 PDF 文件。 這種設定避免了行動裝置的局限性，同時使用戶能夠產生專業的 PDF 文件，包括：

• 帶有可編輯欄位的 PDF 表單
• 多頁設計，包含頁首和頁尾
• 圖片、字體和自訂佈局
• 表格、圖形和資料的自動樣式設定

使用伺服器端程式庫還可以降低應用程式的複雜性，並避免因缺少字體或 Android 和 iOS 之間的渲染差異而導致的錯誤。 這種方法可以讓你更好地控製文件輸出，並在不同的行動平台上保持一致的品質。

設定 PDF 生成 API

首先，建立一個 ASP.NET Core Web API 專案來託管 IronPDF。 安裝 IronPDF NuGet 套件：

Install-Package IronPdf

建立一個 PDF 控制器來處理產生請求：

using IronPdf;
using Microsoft.AspNetCore.Mvc;

namespace PDFGenerationAPI.Controllers
{
    [ApiController]
    [Route("api/[controller]")]
    public class PdfController : ControllerBase
    {
        [HttpPost("generate")]
        public async Task<IActionResult> GeneratePdf([FromBody] PdfRequest request)
        {
            var renderer = new ChromePdfRenderer();
            renderer.RenderingOptions.PaperSize = IronPdf.Rendering.PdfPaperSize.A4;
            renderer.RenderingOptions.MarginTop = 25;
            renderer.RenderingOptions.MarginBottom = 25;
            var pdf = await renderer.RenderHtmlAsPdfAsync(request.HtmlContent);
            return File(pdf.BinaryData, "application/pdf", "document.pdf");
        }
    }

    public class PdfRequest
    {
        public string HtmlContent { get; set; }
    }
}

using IronPdf;
using Microsoft.AspNetCore.Mvc;

namespace PDFGenerationAPI.Controllers
{
    [ApiController]
    [Route("api/[controller]")]
    public class PdfController : ControllerBase
    {
        [HttpPost("generate")]
        public async Task<IActionResult> GeneratePdf([FromBody] PdfRequest request)
        {
            var renderer = new ChromePdfRenderer();
            renderer.RenderingOptions.PaperSize = IronPdf.Rendering.PdfPaperSize.A4;
            renderer.RenderingOptions.MarginTop = 25;
            renderer.RenderingOptions.MarginBottom = 25;
            var pdf = await renderer.RenderHtmlAsPdfAsync(request.HtmlContent);
            return File(pdf.BinaryData, "application/pdf", "document.pdf");
        }
    }

    public class PdfRequest
    {
        public string HtmlContent { get; set; }
    }
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

此控制器接受 HTML 內容並傳回產生的 PDF。 ChromePdfRenderer負責處理轉換，保留 HTML 中的所有 CSS 樣式和 JavaScript 執行。 渲染選項允許自訂紙張尺寸、邊距、頁面寬度和其他 PDF 屬性。 您可以參考 API 文件以了解更多設定方法。

實現 Xamarin 用戶端

在您的 Xamarin.Forms 應用程式中，建立一個服務來與 API 通訊。 此程式碼範例演示了客戶端實作：

using System;
using System.Net.Http;
using System.Text;
using System.Threading.Tasks;
using Newtonsoft.Json;

namespace XamarinFormsClient
{
    public class PdfService
    {
        private readonly HttpClient _httpClient;
        private const string ApiUrl = "https://your-api.com/api/pdf/generate"; // Replace with your API URL

        public PdfService()
        {
            _httpClient = new HttpClient();
        }

        public async Task<byte[]> GeneratePdfAsync(string htmlContent)
        {
            var request = new { HtmlContent = htmlContent };
            var json = JsonConvert.SerializeObject(request);
            var content = new StringContent(json, Encoding.UTF8, "application/json");
            var response = await _httpClient.PostAsync(ApiUrl, content);
            if (response.IsSuccessStatusCode)
                return await response.Content.ReadAsByteArrayAsync();
            throw new Exception("PDF generation failed");
        }
    }
}

using System;
using System.Net.Http;
using System.Text;
using System.Threading.Tasks;
using Newtonsoft.Json;

namespace XamarinFormsClient
{
    public class PdfService
    {
        private readonly HttpClient _httpClient;
        private const string ApiUrl = "https://your-api.com/api/pdf/generate"; // Replace with your API URL

        public PdfService()
        {
            _httpClient = new HttpClient();
        }

        public async Task<byte[]> GeneratePdfAsync(string htmlContent)
        {
            var request = new { HtmlContent = htmlContent };
            var json = JsonConvert.SerializeObject(request);
            var content = new StringContent(json, Encoding.UTF8, "application/json");
            var response = await _httpClient.PostAsync(ApiUrl, content);
            if (response.IsSuccessStatusCode)
                return await response.Content.ReadAsByteArrayAsync();
            throw new Exception("PDF generation failed");
        }
    }
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

此功能負責向伺服器發送 HTML 以及接收以位元組數組形式儲存的 PDF 檔案。 使用JSON序列化可以保證客戶端和伺服器之間正確的資料傳輸。 這些程式碼片段提供了一個基礎，您可以添加進度追蹤或錯誤處理等附加功能進行擴充。

在行動裝置上儲存PDF文件

收到 PDF 檔案後，請使用平台特定的程式碼儲存它。 實施正確的檔案路徑處理和儲存權限控制：

public interface ISaveFile
{
    Task SavePdfAsync(string filename, byte[] pdfData);
}

// iOS Implementation
public class SaveFileIOS : ISaveFile
{
    public async Task SavePdfAsync(string filename, byte[] pdfData)
    {
        var documents = Environment.GetFolderPath(Environment.SpecialFolder.MyDocuments);
        var filePath = Path.Combine(documents, filename);
        await File.WriteAllBytesAsync(filePath, pdfData);
        // Open PDF viewer
        await Launcher.OpenAsync(new OpenFileRequest
        {
            File = new ReadOnlyFile(filePath)
        });
    }
}

public interface ISaveFile
{
    Task SavePdfAsync(string filename, byte[] pdfData);
}

// iOS Implementation
public class SaveFileIOS : ISaveFile
{
    public async Task SavePdfAsync(string filename, byte[] pdfData)
    {
        var documents = Environment.GetFolderPath(Environment.SpecialFolder.MyDocuments);
        var filePath = Path.Combine(documents, filename);
        await File.WriteAllBytesAsync(filePath, pdfData);
        // Open PDF viewer
        await Launcher.OpenAsync(new OpenFileRequest
        {
            File = new ReadOnlyFile(filePath)
        });
    }
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

此程式碼範例展示如何使用平台特定的 API 儲存 PDF 和寫入檔案。 filePath路徑由系統決定，類似的邏輯也適用於具有相應儲存權限的 Android 系統。 透過這種方式處理文件，您可以支援 PDF 表單、多頁和圖像，而無需額外的依賴項。 您可以將產生的文件下載到裝置的文件中心，以便輕鬆存取。

建立專業PDF文檔

透過建構嵌入資料的HTML模板，產生專業的PDF檔案。 此方法可讓您建立包含結構化內容的 PDF 文檔，包括表格行和格式化元素：

public string GenerateInvoiceHtml(Invoice invoice)
{
    return $@"
        <html>
        <head>
            <style>
                body {{ font-family: Arial; }}
                .header {{ background-color: #f0f0f0; padding: 20px; }}
                .invoice-details {{ margin: 20px 0; }}
                table {{ width: 100%; border-collapse: collapse; }}
                th, td {{ padding: 10px; border-bottom: 1px solid #ddd; }}
            </style>
        </head>
        <body>
            <div class='header'>
                <h1>Invoice #{invoice.Number}</h1>
                <p>Date: {invoice.Date:yyyy-MM-dd}</p>
            </div>
            <div class='invoice-details'>
                <table>
                    <tr>
                        <th>Item</th>
                        <th>Quantity</th>
                        <th>Price</th>
                    </tr>
                    {string.Join("", invoice.Items.Select(i => 
                        $"<tr><td>{i.Name}</td><td>{i.Quantity}</td><td>${i.Price}</td></tr>"
                    ))}
                </table>
                <h3>Total: ${invoice.Total}</h3>
            </div>
        </body>
        </html>";
}

public string GenerateInvoiceHtml(Invoice invoice)
{
    return $@"
        <html>
        <head>
            <style>
                body {{ font-family: Arial; }}
                .header {{ background-color: #f0f0f0; padding: 20px; }}
                .invoice-details {{ margin: 20px 0; }}
                table {{ width: 100%; border-collapse: collapse; }}
                th, td {{ padding: 10px; border-bottom: 1px solid #ddd; }}
            </style>
        </head>
        <body>
            <div class='header'>
                <h1>Invoice #{invoice.Number}</h1>
                <p>Date: {invoice.Date:yyyy-MM-dd}</p>
            </div>
            <div class='invoice-details'>
                <table>
                    <tr>
                        <th>Item</th>
                        <th>Quantity</th>
                        <th>Price</th>
                    </tr>
                    {string.Join("", invoice.Items.Select(i => 
                        $"<tr><td>{i.Name}</td><td>{i.Quantity}</td><td>${i.Price}</td></tr>"
                    ))}
                </table>
                <h3>Total: ${invoice.Total}</h3>
            </div>
        </body>
        </html>";
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

此方法根據您的資料模型建立結構化的 HTML，其中每一行代表一個發票項目。 IronPDF 保留所有樣式，建立符合您品牌指南的專業文件。 您還可以添加水印圖章、PNG 圖像和其他視覺元素來增強文件外觀。

常見問題及解決方案

在實施此架構時，您可能會遇到以下挑戰：

*網路逾時*：增加複雜 PDF 文件的HttpClient逾時時間 大檔案處理：串流超過 10MB 的 PDF 文件，以避免記憶體問題 離線場景：對 PDF 產生請求進行排隊，並建立待處理作業的儲存庫 身份驗證：使用 JWT 令牌和使用者權限控制保護端點 速率限制：限制 API 請求頻率以防止系統過載 錯誤處理**：在程式碼中實作適當的錯誤訊息和註釋，以便進行故障排除。 *檔案管理：處理下載後的檔案刪除操作，以管理儲存空間

使用基於 XML 的資料或已定義的模式時，請確保在將內容傳送到 API 之前進行正確的序列化。 新增指向錯誤日誌的連結以便於偵錯，並註冊事件處理程序以追蹤生成進度。

重要提示：Xamarin 已停止支援。

微軟宣布 Xamarin 將於 2024 年 5 月停止支援。對於新項目，請考慮遷移到 .NET MAUI，IronPDF 原生支援多種程式語言的 .NET MAUI。 這樣就無需伺服器端 API，可以直接在行動裝置上產生 PDF 檔案。

部署和授權的考慮因素

為了實現可擴充性，請將您的 API 部署到 Azure 應用程式服務或 AWS Lambda 等雲端平台。 請考慮以下因素：

• IronPDF 許可：伺服器部署需要相應的 IronPDF 許可證。 *託管成本*：考慮 API 託管和頻寬費用 效能**：對頻繁產生的 PDF 檔案使用快取以減少負載 *安全性：對所有介面實作 API 驗證和 HTTPS。

結論

雖然 IronPDF 不直接支援 Xamarin，但其伺服器端 API 方法為行動應用程式中的 PDF 產生提供了一個可靠的解決方案。 該架構利用了 IronPDF 強大的渲染引擎，同時保持了對 iOS 和 Android 平台的跨平台相容性。

準備好在您的 Xamarin 應用程式中實現 PDF 生成功能了嗎？ 立即開始 IronPDF 免費試用，體驗專業的 PDF 建立功能。 對於生產環境部署，請了解我們的授權選項，找到最適合您需求的方案。