Xamarin PCL解决方案中Android平台Intent Service上传实现问询

你提到的问题很常见——因为IntentService是Android平台特有的组件，所以需要通过Xamarin Forms的DependencyService来实现PCL/Shared项目与Android平台代码的交互。下面是一个完整的分步实现方案：

1. 在PCL/Shared项目中定义上传接口 #

首先，我们需要抽象上传功能，让PCL代码不需要关心具体的平台实现：

public interface IUploadService
{
    Task<bool> UploadAsync(Uri serviceAddress, CaptureEntity capture, List<string> imagePaths);
}

这里假设imagePaths是图片文件的本地路径列表（直接传递文件路径比序列化整个文件更高效，避免Intent数据大小限制）。

2. 在Android项目中实现IntentService #

接下来创建Android平台的IntentService，负责后台执行上传逻辑：

[Service]
public class UploadIntentService : IntentService
{
    public UploadIntentService() : base("UploadIntentService") { }

    protected override void OnHandleIntent(Intent intent)
    {
        try
        {
            // 从Intent中获取传递的数据
            var serviceAddress = intent.GetStringExtra("ServiceAddress");
            var captureJson = intent.GetStringExtra("CaptureEntity");
            var imagePaths = intent.GetStringArrayListExtra("ImagePaths");

            // 反序列化CaptureEntity（这里使用Newtonsoft.Json，需要安装NuGet包）
            var capture = JsonConvert.DeserializeObject<CaptureEntity>(captureJson);

            // 执行上传逻辑：打包文本数据和图片文件
            var uploadSuccess = PerformUpload(new Uri(serviceAddress), capture, imagePaths);

            // 可以通过广播通知上传结果（可选）
            SendUploadResultBroadcast(uploadSuccess);
        }
        catch (Exception ex)
        {
            // 处理异常，记录日志
            Console.WriteLine($"Upload failed: {ex.Message}");
            SendUploadResultBroadcast(false);
        }
    }

    private bool PerformUpload(Uri serviceAddress, CaptureEntity capture, List<string> imagePaths)
    {
        // 这里实现具体的上传逻辑：
        // 1. 创建MultipartFormDataContent
        // 2. 添加文本字段（CaptureEntity的属性）
        // 3. 逐个添加图片文件
        // 4. 使用HttpClient发送请求
        
        using (var client = new HttpClient())
        using (var content = new MultipartFormDataContent())
        {
            // 添加文本数据
            content.Add(new StringContent(capture.Id.ToString()), "CaptureId");
            content.Add(new StringContent(capture.Description), "Description");
            // 根据你的CaptureEntity属性继续添加...

            // 添加图片文件
            foreach (var path in imagePaths)
            {
                var fileStream = new FileStream(path, FileMode.Open, FileAccess.Read);
                content.Add(new StreamContent(fileStream), $"Image{imagePaths.IndexOf(path)}", Path.GetFileName(path));
            }

            // 发送请求
            var response = client.PostAsync(serviceAddress, content).Result;
            return response.IsSuccessStatusCode;
        }
    }

    private void SendUploadResultBroadcast(bool success)
    {
        var resultIntent = new Intent("com.yourapp.UPLOAD_RESULT");
        resultIntent.PutExtra("Success", success);
        LocalBroadcastManager.GetInstance(this).SendBroadcast(resultIntent);
    }
}

注意：

• 必须给Service添加[Service]特性，否则系统无法识别。
• PerformUpload方法中使用同步调用（.Result），因为OnHandleIntent本身就是后台线程，不需要异步。
• 如果需要通知UI上传结果，可以使用LocalBroadcastManager发送广播，在PCL中注册接收。

3. 在Android项目中实现上传接口的依赖服务 #

创建实现IUploadService的类，负责启动IntentService并传递数据：

[assembly: Dependency(typeof(AndroidUploadService))]
namespace YourApp.Droid
{
    public class AndroidUploadService : IUploadService
    {
        public async Task<bool> UploadAsync(Uri serviceAddress, CaptureEntity capture, List<string> imagePaths)
        {
            // 序列化CaptureEntity为JSON字符串，方便通过Intent传递
            var captureJson = JsonConvert.SerializeObject(capture);

            // 创建Intent并添加参数
            var intent = new Intent(Android.App.Application.Context, typeof(UploadIntentService));
            intent.PutExtra("ServiceAddress", serviceAddress.ToString());
            intent.PutExtra("CaptureEntity", captureJson);
            intent.PutStringArrayListExtra("ImagePaths", imagePaths);

            // 启动IntentService
            Android.App.Application.Context.StartService(intent);

            // 如果需要等待上传结果，可以注册广播监听，这里先返回true表示已启动上传
            // 或者根据业务需求调整逻辑
            return true;
        }
    }
}

4. 在PCL/Shared项目中调用上传服务 #

现在就可以在PCL代码中直接调用上传功能了：

// 获取依赖服务实例
var uploadService = DependencyService.Get<IUploadService>();

// 准备上传数据
var serviceUri = new Uri("http://your-local-server/upload");
var capture = new CaptureEntity { Id = 1, Description = "测试上传" };
var imagePaths = new List<string> { "/storage/emulated/0/Pic1.jpg", "/storage/emulated/0/Pic2.jpg" };

// 执行上传
var isStarted = await uploadService.UploadAsync(serviceUri, capture, imagePaths);

关键注意事项 #

• Intent数据大小限制: Intent的Extras不能传递过大的数据，所以我们传递图片路径而非图片本身，避免超出限制。
• 权限: 确保AndroidManifest.xml中添加了网络权限和文件读取权限：

  <uses-permission android:name="android.permission.INTERNET" />
  <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
  

  对于Android 6.0+，还需要动态申请读取存储权限。
• 后台执行限制: 从Android Oreo开始，后台Service的行为有严格限制，如果你需要在后台长时间运行上传，可以考虑使用JobIntentService替代IntentService，它更适配新的Android版本。

内容的提问来源于stack exchange，提问作者GANDA1F