當前位置：首頁 > 编程资源 > 编程问答 >内容正文

编程问答

Xamarin.Forms客户端第一版

發布時間：2023/12/4 编程问答 46 豆豆

生活随笔收集整理的這篇文章主要介紹了 Xamarin.Forms客户端第一版小編覺得挺不錯的,現在分享給大家,幫大家做個參考.

1. 功能簡介

1.1. 讀取手機基本信息

主要使用Xamarin.Essentials庫獲取設備基本信息，Xam.Plugin.DeviceInfo插件獲取App Id，其實該插件也能獲取設備基本信息。

1.2. 讀取手機聯系人信息

Android和iOS工程具體實現聯系人讀取服務，使用到DependencyService獲取服務功能。

1.3. 應用本地化

使用資源文件實現本地化，目前只做了中、英文。

2. 詳細功能說明

2.1. 讀取手機基本信息

Xamarin.Essentials庫用于獲取手機基本信息，比如手機廠商、型號、名稱、類型、版本等；Xam.Plugin.DeviceInfo插件獲取App Id，用于唯一標識不同手機，獲取信息見下圖：

代碼結構如下圖：

ClientInfoViewModel.cs

using Plugin.DeviceInfo;

using System;

using Xamarin.Essentials;

namespace TerminalMACS.Clients.App.ViewModels

{

? /// <summary>

? /// Client base information page ViewModel

? /// </summary>

? ?public class ClientInfoViewModel : BaseViewModel

? ?{

? ? ? /// <summary>

? ? ? /// Gets or sets the id of the application.

? ? ? /// </summary>

? ? ? ?public string AppId { get; set; } = CrossDeviceInfo.Current.GenerateAppId();

? ? ? /// <summary>

? ? ? /// Gets or sets the model of the device.

? ? ? /// </summary>

? ? ? ?public string Model { get; private set; } = DeviceInfo.Model;

? ? ? /// <summary>

? ? ? /// Gets or sets the manufacturer of the device.

? ? ? /// </summary>

? ? ? ?public string Manufacturer { get; private set; } = DeviceInfo.Manufacturer;

? ? ? /// <summary>

? ? ? /// Gets or sets the name of the device.

? ? ? /// </summary>

? ? ? ?public string Name { get; private set; } = DeviceInfo.Name;

? ? ? /// <summary>

? ? ? /// Gets or sets the version of the operating system.

? ? ? /// </summary>

? ? ? ?public string VersionString { get; private set; } = DeviceInfo.VersionString;

? ? ? /// <summary>

? ? ? /// Gets or sets the version of the operating system.

? ? ? /// </summary>

? ? ? ?public Version Version { get; private set; } = DeviceInfo.Version;

? ? ? /// <summary>

? ? ? /// Gets or sets the platform or operating system of the device.

? ? ? /// </summary>

? ? ? ?public DevicePlatform Platform { get; private set; } = DeviceInfo.Platform;

? ? ? /// <summary>

? ? ? /// Gets or sets the idiom of the device.

? ? ? /// </summary>

? ? ? ?public DeviceIdiom Idiom { get; private set; } = DeviceInfo.Idiom;

? ? ? /// <summary>

? ? ? /// Gets or sets the type of device the application is running on.

? ? ? /// </summary>

? ? ? ?public DeviceType DeviceType { get; private set; } = DeviceInfo.DeviceType;

? ?}

}

ClientInfoPage.xaml

<?xml version="1.0" encoding="utf-8" ?>

<ContentPage xmlns="http://xamarin.com/schemas/2014/forms"

? ? ? ? ? ? xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"

? ? ? ? ? ? xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"

? ? ? ? ? ? xmlns:d="http://xamarin.com/schemas/2014/forms/design"

? ? ? ? ? ? xmlns:resources="clr-namespace:TerminalMACS.Clients.App.Resx"

? ? ? ? ? ? xmlns:vm="clr-namespace:TerminalMACS.Clients.App.ViewModels"

? ? ? ? ? ? mc:Ignorable="d"

? ? ? ? ? ? x:Class="TerminalMACS.Clients.App.Views.ClientInfoPage"

? ? ? ? ? ? Title="{x:Static resources:AppResource.Title_ClientInfoPage}">

? ?<ContentPage.BindingContext>

? ? ? ?<vm:ClientInfoViewModel/>

? ?</ContentPage.BindingContext>

? ?<ContentPage.Content>

? ? ? ?<StackLayout>

? ? ? ? ? ?<Label Text="{x:Static resources:AppResource.AppId}"/>

? ? ? ? ? ?<Label Text="{Binding AppId}" FontAttributes="Bold" Margin="10,0,0,10"/>

? ? ? ? ? ?

? ? ? ? ? ?<Label Text="{x:Static resources:AppResource.DeviceModel}"/>

? ? ? ? ? ?<Label Text="{Binding Model}" FontAttributes="Bold" Margin="10,0,0,10"/>

? ? ? ? ? ?<Label Text="{x:Static resources:AppResource.DeviceManufacturer}"/>

? ? ? ? ? ?<Label Text="{Binding Manufacturer}" FontAttributes="Bold" Margin="10,0,0,10"/>

? ? ? ? ? ?

? ? ? ? ? ?<Label Text="{x:Static resources:AppResource.DeviceName}"/>

? ? ? ? ? ?<Label Text="{Binding Name}" FontAttributes="Bold" Margin="10,0,0,10"/>

? ? ? ? ? ?

? ? ? ? ? ?<Label Text="{x:Static resources:AppResource.DeviceVersionString}"/>

? ? ? ? ? ?<Label Text="{Binding VersionString}" FontAttributes="Bold" Margin="10,0,0,10"/>

? ? ? ? ? ?<Label Text="{x:Static resources:AppResource.DevicePlatform}"/>

? ? ? ? ? ?<Label Text="{Binding Platform}" FontAttributes="Bold" Margin="10,0,0,10"/>

? ? ? ? ? ?

? ? ? ? ? ?<Label Text="{x:Static resources:AppResource.DeviceIdiom}"/>

? ? ? ? ? ?<Label Text="{Binding Idiom}" FontAttributes="Bold" Margin="10,0,0,10"/>

? ? ? ? ? ?

? ? ? ? ? ?<Label Text="{x:Static resources:AppResource.DeviceType}"/>

? ? ? ? ? ?<Label Text="{Binding DeviceType}" FontAttributes="Bold" Margin="10,0,0,10"/>

? ? ? ?</StackLayout>

? ?</ContentPage.Content>

</ContentPage>

2.2. 讀取手機聯系人信息

Android和iOS工程具體實現聯系人讀取服務，使用到DependencyService獲取服務功能，功能截圖如下：

2.2.1. TerminalMACS.Clients.App

代碼結構如下圖：

2.2.1.1. 聯系人實體類：Contacts.cs

目前只獲取聯系人名稱、圖片、電子郵件（可能多個）、電話號碼（可能多個），更多可以擴展。

namespace TerminalMACS.Clients.App.Models

{

? /// <summary>

? /// Contact information entity.

? /// </summary>

? ?public class Contact

? ?{

? ? ? /// <summary>

? ? ? /// Gets or sets the name

? ? ? /// </summary>

? ? ? ?public string Name { get; set; }

? ? ? /// <summary>

? ? ? /// Gets or sets the image

? ? ? /// </summary>

? ? ? ?public string Image { get; set; }

? ? ? /// <summary>

? ? ? /// Gets or sets the emails

? ? ? /// </summary>

? ? ? ?public string[] Emails { get; set; }

? ? ? /// <summary>

? ? ? /// Gets or sets the phone numbers

? ? ? /// </summary>

? ? ? ?public string[] PhoneNumbers { get; set; }

? ?}

}

2.2.1.2. 聯系人服務接口：IContactsService.cs

包括：

一個聯系人獲取請求接口：RetrieveContactsAsync
一個讀取一條聯系人結果通知事件：OnContactLoaded

該接口由具體平臺(Android和iOS)實現。

using System;

using System.Collections.Generic;

using System.Threading;

using System.Threading.Tasks;

using TerminalMACS.Clients.App.Models;

namespace TerminalMACS.Clients.App.Services

{

? /// <summary>

? /// Read a contact record notification event parameter.

? /// </summary>

? ?public class ContactEventArgs:EventArgs

? ?{

? ? ? ?public Contact Contact { get; }

? ? ? ?public ContactEventArgs(Contact contact)

? ? ? ?{

? ? ? ? ? ?Contact = contact;

? ? ? ?}

? ?}

? /// <summary>

? /// Contact service interface, which is required for Android and iOS terminal specific

? /// ?contact acquisition service needs to implement this interface.

? /// </summary>

? ?public interface IContactsService

? ?{

? ? ? /// <summary>

? ? ? /// Read a contact record and notify the shared library through this event.

? ? ? /// </summary>

? ? ? ?event EventHandler<ContactEventArgs> OnContactLoaded;

? ? ? /// <summary>

? ? ? /// Loading or not

? ? ? /// </summary>

? ? ? ?bool IsLoading { get; }

? ? ? /// <summary>

? ? ? /// Try to get all contact information

? ? ? /// </summary>

? ? ? /// <param name="token"></param>

? ? ? /// <returns></returns>

? ? ? ?Task<IList<Contact>> RetrieveContactsAsync(CancellationToken? token = null);

? ?}

}

2.2.1.3. 聯系人VM：ContactViewModel.cs

VM提供下面兩個功能：

全部聯系人加載。

聯系人關鍵字查詢。

using System;

using System.Collections;

using System.Collections.Generic;

using System.Collections.ObjectModel;

using System.Linq;

using System.Threading.Tasks;

using System.Windows.Input;

using TerminalMACS.Clients.App.Models;

using TerminalMACS.Clients.App.Resx;

using TerminalMACS.Clients.App.Services;

using Xamarin.Forms;

namespace TerminalMACS.Clients.App.ViewModels

{

? /// <summary>

? /// Contact page ViewModel

? /// </summary>

? ?public class ContactViewModel : BaseViewModel

? ?{

? ? ? /// <summary>

? ? ? /// Contact service interface

? ? ? /// </summary>

? ? ? ?IContactsService _contactService;

? ? ? ?private string _SearchText;

? ? ? /// <summary>

? ? ? /// Gets or sets the search text of the contact list.

? ? ? /// </summary>

? ? ? ?public string SearchText

? ? ? ?{

? ? ? ? ? ?get { return _SearchText; }

? ? ? ? ? ?set

? ? ? ? ? ?{

? ? ? ? ? ? ? ?SetProperty(ref _SearchText, value);

? ? ? ? ? ?}

? ? ? ?}

? ? ? /// <summary>

? ? ? /// The search contact command.

? ? ? /// </summary>

? ? ? ?public ICommand RaiseSearchCommand { get; }

? ? ? /// <summary>

? ? ? /// The contact list.

? ? ? /// </summary>

? ? ? ?public ObservableCollection<Contact> Contacts { get; set; }

? ? ? ?private List<Contact> _FilteredContacts;

? ? ? /// <summary>

? ? ? /// Contact filter list.

? ? ? /// </summary>

? ? ? ?public List<Contact> FilteredContacts

? ? ? ?{

? ? ? ? ? ?get { return _FilteredContacts; }

? ? ? ? ? ?set

? ? ? ? ? ?{

? ? ? ? ? ? ? ?SetProperty(ref _FilteredContacts, value);

? ? ? ? ? ?}

? ? ? ?}

? ? ? ?public ContactViewModel()

? ? ? ?{

? ? ? ? ? ?_contactService = DependencyService.Get<IContactsService>();

? ? ? ? ? ?Contacts = new ObservableCollection<Contact>();

? ? ? ? ? ?Xamarin.Forms.BindingBase.EnableCollectionSynchronization(Contacts, null, ObservableCollectionCallback);

? ? ? ? ? ?_contactService.OnContactLoaded += OnContactLoaded;

? ? ? ? ? ?LoadContacts();

? ? ? ? ? ?RaiseSearchCommand = new Command(RaiseSearchHandle);

? ? ? ?}

? ? ? /// <summary>

? ? ? /// Filter contact list

? ? ? /// </summary>

? ? ? ?void RaiseSearchHandle()

? ? ? ?{

? ? ? ? ? ?if (string.IsNullOrEmpty(SearchText))

? ? ? ? ? ?{

? ? ? ? ? ? ? ?FilteredContacts = Contacts.ToList();

? ? ? ? ? ? ? ?return;

? ? ? ? ? ?}

? ? ? ? ? ?Func<Contact, bool> checkContact = (s) =>

? ? ? ? ? ?{

? ? ? ? ? ? ? ?if (!string.IsNullOrWhiteSpace(s.Name) && s.Name.ToLower().Contains(SearchText.ToLower()))

? ? ? ? ? ? ? ?{

? ? ? ? ? ? ? ? ? ?return true;

? ? ? ? ? ? ? ?}

? ? ? ? ? ? ? ?else if (s.PhoneNumbers.Length > 0 && s.PhoneNumbers.ToList().Exists(cu => cu.ToString().Contains(SearchText)))

? ? ? ? ? ? ? ?{

? ? ? ? ? ? ? ? ? ?return true;

? ? ? ? ? ? ? ?}

? ? ? ? ? ? ? ?return false;

? ? ? ? ? ?};

? ? ? ? ? ?FilteredContacts = Contacts.ToList().Where(checkContact).ToList();

? ? ? ?}

? ? ? /// <summary>

? ? ? /// BindingBase.EnableCollectionSynchronization

? ? ? /// ? ? Enable cross thread updates for collections

? ? ? /// </summary>

? ? ? /// <param name="collection"></param>

? ? ? /// <param name="context"></param>

? ? ? /// <param name="accessMethod"></param>

? ? ? /// <param name="writeAccess"></param>

? ? ? ?void ObservableCollectionCallback(IEnumerable collection, object context, Action accessMethod, bool writeAccess)

? ? ? ?{

? ? ? ? ? // `lock` ensures that only one thread access the collection at a time

? ? ? ? ? ?lock (collection)

? ? ? ? ? ?{

? ? ? ? ? ? ? ?accessMethod?.Invoke();

? ? ? ? ? ?}

? ? ? ?}

? ? ? /// <summary>

? ? ? /// Received a event notification that a contact information was successfully read.

? ? ? /// </summary>

? ? ? /// <param name="sender"></param>

? ? ? /// <param name="e"></param>

? ? ? ?private void OnContactLoaded(object sender, ContactEventArgs e)

? ? ? ?{

? ? ? ? ? ?Contacts.Add(e.Contact);

? ? ? ? ? ?RaiseSearchHandle();

? ? ? ?}

? ? ? /// <summary>

? ? ? /// Read contact information asynchronously

? ? ? /// </summary>

? ? ? /// <returns></returns>

? ? ? ?async Task LoadContacts()

? ? ? ?{

? ? ? ? ? ?try

? ? ? ? ? ?{

? ? ? ? ? ? ? ?await _contactService.RetrieveContactsAsync();

? ? ? ? ? ?}

? ? ? ? ? ?catch (TaskCanceledException)

? ? ? ? ? ?{

? ? ? ? ? ? ? ?Console.WriteLine(AppResource.TaskCancelled);

? ? ? ? ? ?}

? ? ? ?}

? ?}

}

2.2.1.4. 聯系人展示頁面：ContactPage.xaml

簡單的布局，一個StackLayout布局容器豎直排列，一個SearchBar提供關鍵字搜索功能。

<?xml version="1.0" encoding="utf-8" ?>

<ContentPage xmlns="http://xamarin.com/schemas/2014/forms"

? ? ? ? ? ? xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"

? ? ? ? ? ? xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"

? ? ? ? ? ? xmlns:d="http://xamarin.com/schemas/2014/forms/design"

? ? ? ? ? ? xmlns:resources="clr-namespace:TerminalMACS.Clients.App.Resx"

? ? ? ? ? ? xmlns:vm="clr-namespace:TerminalMACS.Clients.App.ViewModels"

? ? ? ? ? ? xmlns:ios="clr-namespace:Xamarin.Forms.PlatformConfiguration.iOSSpecific;assembly=Xamarin.Forms.Core"

? ? ? ? ? ? mc:Ignorable="d"

? ? ? ? ? ? Title="{x:Static resources:AppResource.Title_ContactPage}"

? ? ? ? ? ? x:Class="TerminalMACS.Clients.App.Views.ContactPage"

? ? ? ? ? ? ios:Page.UseSafeArea="true">

? ?<ContentPage.BindingContext>

? ? ? ?<vm:ContactViewModel/>

? ?</ContentPage.BindingContext>

? ?<ContentPage.Content>

? ? ? ?<StackLayout>

? ? ? ? ? ?<SearchBar x:Name="filterText"

? ? ? ? ? ? ? ? ? ? ? ?HeightRequest="40"

? ? ? ? ? ? ? ? ? ? ? ?Text="{Binding SearchText}"

? ? ? ? ? ? ? ? ? ? ? SearchCommand="{Binding RaiseSearchCommand}"/>

? ? ? ? ? ?<ListView ? ItemsSource="{Binding FilteredContacts}"

? ? ? ? ? ? ? ? ? ? ? ?HasUnevenRows="True">

? ? ? ? ? ? ? ?<ListView.ItemTemplate>

? ? ? ? ? ? ? ? ? ?<DataTemplate>

? ? ? ? ? ? ? ? ? ? ? ?<ViewCell>

? ? ? ? ? ? ? ? ? ? ? ? ? ?<StackLayout Padding="10"

? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? Orientation="Horizontal">

? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ?<Image ?Source="{Binding Image}"

? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ?VerticalOptions="Center"

? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ?x:Name="image"

? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ?Aspect="AspectFit"

? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ?HeightRequest="60"/>

? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ?<StackLayout VerticalOptions="Center">

? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ?<Label Text="{Binding Name}"

? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? FontAttributes="Bold"/>

? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ?<Label Text="{Binding PhoneNumbers[0]}"/>

? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ?<Label Text="{Binding Emails[0]}"/>

? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ?</StackLayout>

? ? ? ? ? ? ? ? ? ? ? ? ? ?</StackLayout>

? ? ? ? ? ? ? ? ? ? ? ?</ViewCell>

? ? ? ? ? ? ? ? ? ?</DataTemplate>

? ? ? ? ? ? ? ?</ListView.ItemTemplate>

? ? ? ? ? ?</ListView>

? ? ? ?</StackLayout>

? ?</ContentPage.Content>

</ContentPage>

2.2.2. Android

代碼結構如下圖：

AndroidManifest.xml：寫入讀、寫聯系人權限請求。
ContactsService.cs：具體的聯系人權限請求、數據讀取操作。
MainActivity.cs：接收權限請求結果
MainApplicaion.cs：此類未添加任務關鍵代碼，但必不可少，否則無法正確彈出權限請求窗口。
PermissionUtil.cs：權限請求結果判斷

2.2.2.1. AndroidManifest.xml添加權限

只添加下面這一行即可：

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

2.2.2.2. ContactsService.cs

Android聯系人獲取實現服務，實現IContactsService。注意命名空間上的特性代碼，必須添加上這個特性后，在前面的聯系人VM中才能使用DependencyService.Get()獲取此服務實例，默認服務是單例的：

[assembly: Xamarin.Forms.Dependency(typeof(TerminalMACS.Clients.App.iOS.Services.ContactsService))]

using Contacts;

using Foundation;

using System;

using System.Collections.Generic;

using System.IO;

using System.Linq;

using System.Threading;

using System.Threading.Tasks;

using TerminalMACS.Clients.App.Models;

using TerminalMACS.Clients.App.Services;

[assembly: Xamarin.Forms.Dependency(typeof(TerminalMACS.Clients.App.iOS.Services.ContactsService))]

namespace TerminalMACS.Clients.App.iOS.Services

{

? /// <summary>

? /// Contact service.

? /// </summary>

? ?public class ContactsService : NSObject, IContactsService

? ?{

? ? ? ?const string ThumbnailPrefix = "thumb";

? ? ? ?bool requestStop = false;

? ? ? ?public event EventHandler<ContactEventArgs> OnContactLoaded;

? ? ? ?bool _isLoading = false;

? ? ? ?public bool IsLoading => _isLoading;

? ? ? /// <summary>

? ? ? /// Asynchronous request permission

? ? ? /// </summary>

? ? ? /// <returns></returns>

? ? ? ?public async Task<bool> RequestPermissionAsync()

? ? ? ?{

? ? ? ? ? ?var status = CNContactStore.GetAuthorizationStatus(CNEntityType.Contacts);

? ? ? ? ? ?Tuple<bool, NSError> authotization = new Tuple<bool, NSError>(status == CNAuthorizationStatus.Authorized, null);

? ? ? ? ? ?if (status == CNAuthorizationStatus.NotDetermined)

? ? ? ? ? ?{

? ? ? ? ? ? ? ?using (var store = new CNContactStore())

? ? ? ? ? ? ? ?{

? ? ? ? ? ? ? ? ? ?authotization = await store.RequestAccessAsync(CNEntityType.Contacts);

? ? ? ? ? ? ? ?}

? ? ? ? ? ?}

? ? ? ? ? ?return authotization.Item1;

? ? ? ?}

? ? ? /// <summary>

? ? ? /// Request contact asynchronously. This method is called by the interface.

? ? ? /// </summary>

? ? ? /// <param name="cancelToken"></param>

? ? ? /// <returns></returns>

? ? ? ?public async Task<IList<Contact>> RetrieveContactsAsync(CancellationToken? cancelToken = null)

? ? ? ?{

? ? ? ? ? ?requestStop = false;

? ? ? ? ? ?if (!cancelToken.HasValue)

? ? ? ? ? ? ? ?cancelToken = CancellationToken.None;

? ? ? ? ? // We create a TaskCompletionSource of decimal

? ? ? ? ? ?var taskCompletionSource = new TaskCompletionSource<IList<Contact>>();

? ? ? ? ? // Registering a lambda into the cancellationToken

? ? ? ? ? ?cancelToken.Value.Register(() =>

? ? ? ? ? ?{

? ? ? ? ? ? ? // We received a cancellation message, cancel the TaskCompletionSource.Task

? ? ? ? ? ? ? ?requestStop = true;

? ? ? ? ? ? ? ?taskCompletionSource.TrySetCanceled();

? ? ? ? ? ?});

? ? ? ? ? ?_isLoading = true;

? ? ? ? ? ?var task = LoadContactsAsync();

? ? ? ? ? // Wait for the first task to finish among the two

? ? ? ? ? ?var completedTask = await Task.WhenAny(task, taskCompletionSource.Task);

? ? ? ? ? ?_isLoading = false;

? ? ? ? ? ?return await completedTask;

? ? ? ?}

? ? ? /// <summary>

? ? ? /// Load contacts asynchronously, fact reading method of address book.

? ? ? /// </summary>

? ? ? /// <returns></returns>

? ? ? ?async Task<IList<Contact>> LoadContactsAsync()

? ? ? ?{

? ? ? ? ? ?IList<Contact> contacts = new List<Contact>();

? ? ? ? ? ?var hasPermission = await RequestPermissionAsync();

? ? ? ? ? ?if (hasPermission)

? ? ? ? ? ?{

? ? ? ? ? ? ? ?NSError error = null;

? ? ? ? ? ? ? ?var keysToFetch = new[] { CNContactKey.PhoneNumbers, CNContactKey.GivenName, CNContactKey.FamilyName, CNContactKey.EmailAddresses, CNContactKey.ImageDataAvailable, CNContactKey.ThumbnailImageData };

? ? ? ? ? ? ? ?var request = new CNContactFetchRequest(keysToFetch: keysToFetch);

? ? ? ? ? ? ? ?request.SortOrder = CNContactSortOrder.GivenName;

? ? ? ? ? ? ? ?using (var store = new CNContactStore())

? ? ? ? ? ? ? ?{

? ? ? ? ? ? ? ? ? ?var result = store.EnumerateContacts(request, out error, new CNContactStoreListContactsHandler((CNContact c, ref bool stop) =>

? ? ? ? ? ? ? ? ? ?{

? ? ? ? ? ? ? ? ? ? ? ?string path = null;

? ? ? ? ? ? ? ? ? ? ? ?if (c.ImageDataAvailable)

? ? ? ? ? ? ? ? ? ? ? ?{

? ? ? ? ? ? ? ? ? ? ? ? ? ?path = path = Path.Combine(Path.GetTempPath(), $"{ThumbnailPrefix}-{Guid.NewGuid()}");

? ? ? ? ? ? ? ? ? ? ? ? ? ?if (!File.Exists(path))

? ? ? ? ? ? ? ? ? ? ? ? ? ?{

? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ?var imageData = c.ThumbnailImageData;

? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ?imageData?.Save(path, true);

? ? ? ? ? ? ? ? ? ? ? ? ? ?}

? ? ? ? ? ? ? ? ? ? ? ?}

? ? ? ? ? ? ? ? ? ? ? ?var contact = new Contact()

? ? ? ? ? ? ? ? ? ? ? ?{

? ? ? ? ? ? ? ? ? ? ? ? ? ?Name = string.IsNullOrEmpty(c.FamilyName) ? c.GivenName : $"{c.GivenName} {c.FamilyName}",

? ? ? ? ? ? ? ? ? ? ? ? ? ?Image = path,

? ? ? ? ? ? ? ? ? ? ? ? ? ?PhoneNumbers = c.PhoneNumbers?.Select(p => p?.Value?.StringValue).ToArray(),

? ? ? ? ? ? ? ? ? ? ? ? ? ?Emails = c.EmailAddresses?.Select(p => p?.Value?.ToString()).ToArray(),

? ? ? ? ? ? ? ? ? ? ? ?};

? ? ? ? ? ? ? ? ? ? ? ?if (!string.IsNullOrWhiteSpace(contact.Name))

? ? ? ? ? ? ? ? ? ? ? ?{

? ? ? ? ? ? ? ? ? ? ? ? ? ?OnContactLoaded?.Invoke(this, new ContactEventArgs(contact));

? ? ? ? ? ? ? ? ? ? ? ? ? ?contacts.Add(contact);

? ? ? ? ? ? ? ? ? ? ? ?}

? ? ? ? ? ? ? ? ? ? ? ?stop = requestStop;

? ? ? ? ? ? ? ? ? ?}));

? ? ? ? ? ? ? ?}

? ? ? ? ? ?}

? ? ? ? ? ?return contacts;

? ? ? ?}

? ?}

}

2.2.2.3. MainActivity.cs

代碼簡單，只在OnRequestPermissionsResult方法中接收權限請求結果：

// The contact service processes the result of the permission request.

ContactsService.OnRequestPermissionsResult(requestCode, permissions, grantResults);

2.2.3. iOS

代碼結構如下圖：

ContactsService.cs：具體的聯系人權限請求、數據讀取操作。
Info.plist：權限請求時描述文件

2.2.3.1. ContactsService.cs

iOS具體的聯系人讀取服務，實現IContactsService接口，原理同Android聯系人服務類似，本人無調試環境，iOS此功能未測試。

using Contacts;

using Foundation;

using System;

using System.Collections.Generic;

using System.IO;

using System.Linq;

using System.Threading;

using System.Threading.Tasks;

using TerminalMACS.Clients.App.Models;

using TerminalMACS.Clients.App.Services;

[assembly: Xamarin.Forms.Dependency(typeof(TerminalMACS.Clients.App.iOS.Services.ContactsService))]

namespace TerminalMACS.Clients.App.iOS.Services

{

? /// <summary>

? /// Contact service.

? /// </summary>

? ?public class ContactsService : NSObject, IContactsService

? ?{

? ? ? ?const string ThumbnailPrefix = "thumb";

? ? ? ?bool requestStop = false;

? ? ? ?public event EventHandler<ContactEventArgs> OnContactLoaded;

? ? ? ?bool _isLoading = false;

? ? ? ?public bool IsLoading => _isLoading;

? ? ? /// <summary>

? ? ? /// Asynchronous request permission

? ? ? /// </summary>

? ? ? /// <returns></returns>

? ? ? ?public async Task<bool> RequestPermissionAsync()

? ? ? ?{

? ? ? ? ? ?var status = CNContactStore.GetAuthorizationStatus(CNEntityType.Contacts);

? ? ? ? ? ?Tuple<bool, NSError> authotization = new Tuple<bool, NSError>(status == CNAuthorizationStatus.Authorized, null);

? ? ? ? ? ?if (status == CNAuthorizationStatus.NotDetermined)

? ? ? ? ? ?{

? ? ? ? ? ? ? ?using (var store = new CNContactStore())

? ? ? ? ? ? ? ?{

? ? ? ? ? ? ? ? ? ?authotization = await store.RequestAccessAsync(CNEntityType.Contacts);

? ? ? ? ? ? ? ?}

? ? ? ? ? ?}

? ? ? ? ? ?return authotization.Item1;

? ? ? ?}

? ? ? /// <summary>

? ? ? /// Request contact asynchronously. This method is called by the interface.

? ? ? /// </summary>

? ? ? /// <param name="cancelToken"></param>

? ? ? /// <returns></returns>

? ? ? ?public async Task<IList<Contact>> RetrieveContactsAsync(CancellationToken? cancelToken = null)

? ? ? ?{

? ? ? ? ? ?requestStop = false;

? ? ? ? ? ?if (!cancelToken.HasValue)

? ? ? ? ? ? ? ?cancelToken = CancellationToken.None;

? ? ? ? ? // We create a TaskCompletionSource of decimal

? ? ? ? ? ?var taskCompletionSource = new TaskCompletionSource<IList<Contact>>();

? ? ? ? ? // Registering a lambda into the cancellationToken

? ? ? ? ? ?cancelToken.Value.Register(() =>

? ? ? ? ? ?{

? ? ? ? ? ? ? // We received a cancellation message, cancel the TaskCompletionSource.Task

? ? ? ? ? ? ? ?requestStop = true;

? ? ? ? ? ? ? ?taskCompletionSource.TrySetCanceled();

? ? ? ? ? ?});

? ? ? ? ? ?_isLoading = true;

? ? ? ? ? ?var task = LoadContactsAsync();

? ? ? ? ? // Wait for the first task to finish among the two

? ? ? ? ? ?var completedTask = await Task.WhenAny(task, taskCompletionSource.Task);

? ? ? ? ? ?_isLoading = false;

? ? ? ? ? ?return await completedTask;

? ? ? ?}

? ? ? /// <summary>

? ? ? /// Load contacts asynchronously, fact reading method of address book.

? ? ? /// </summary>

? ? ? /// <returns></returns>

? ? ? ?async Task<IList<Contact>> LoadContactsAsync()

? ? ? ?{

? ? ? ? ? ?IList<Contact> contacts = new List<Contact>();

? ? ? ? ? ?var hasPermission = await RequestPermissionAsync();

? ? ? ? ? ?if (hasPermission)

? ? ? ? ? ?{

? ? ? ? ? ? ? ?NSError error = null;

? ? ? ? ? ? ? ?var request = new CNContactFetchRequest(keysToFetch: keysToFetch);

? ? ? ? ? ? ? ?request.SortOrder = CNContactSortOrder.GivenName;

? ? ? ? ? ? ? ?using (var store = new CNContactStore())

? ? ? ? ? ? ? ?{

? ? ? ? ? ? ? ? ? ?var result = store.EnumerateContacts(request, out error, new CNContactStoreListContactsHandler((CNContact c, ref bool stop) =>

? ? ? ? ? ? ? ? ? ?{

? ? ? ? ? ? ? ? ? ? ? ?string path = null;

? ? ? ? ? ? ? ? ? ? ? ?if (c.ImageDataAvailable)

? ? ? ? ? ? ? ? ? ? ? ?{

? ? ? ? ? ? ? ? ? ? ? ? ? ?path = path = Path.Combine(Path.GetTempPath(), $"{ThumbnailPrefix}-{Guid.NewGuid()}");

? ? ? ? ? ? ? ? ? ? ? ? ? ?if (!File.Exists(path))

? ? ? ? ? ? ? ? ? ? ? ? ? ?{

? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ?var imageData = c.ThumbnailImageData;

? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ?imageData?.Save(path, true);

? ? ? ? ? ? ? ? ? ? ? ? ? ?}

? ? ? ? ? ? ? ? ? ? ? ?}

? ? ? ? ? ? ? ? ? ? ? ?var contact = new Contact()

? ? ? ? ? ? ? ? ? ? ? ?{

? ? ? ? ? ? ? ? ? ? ? ? ? ?Name = string.IsNullOrEmpty(c.FamilyName) ? c.GivenName : $"{c.GivenName} {c.FamilyName}",

? ? ? ? ? ? ? ? ? ? ? ? ? ?Image = path,

? ? ? ? ? ? ? ? ? ? ? ? ? ?PhoneNumbers = c.PhoneNumbers?.Select(p => p?.Value?.StringValue).ToArray(),

? ? ? ? ? ? ? ? ? ? ? ? ? ?Emails = c.EmailAddresses?.Select(p => p?.Value?.ToString()).ToArray(),

? ? ? ? ? ? ? ? ? ? ? ?};

? ? ? ? ? ? ? ? ? ? ? ?if (!string.IsNullOrWhiteSpace(contact.Name))

? ? ? ? ? ? ? ? ? ? ? ?{

? ? ? ? ? ? ? ? ? ? ? ? ? ?OnContactLoaded?.Invoke(this, new ContactEventArgs(contact));

? ? ? ? ? ? ? ? ? ? ? ? ? ?contacts.Add(contact);

? ? ? ? ? ? ? ? ? ? ? ?}

? ? ? ? ? ? ? ? ? ? ? ?stop = requestStop;

? ? ? ? ? ? ? ? ? ?}));

? ? ? ? ? ? ? ?}

? ? ? ? ? ?}

? ? ? ? ? ?return contacts;

? ? ? ?}

? ?}

}

2.2.3.2. Info.plist

聯系人權限請求說明?

2.3. 應用本地化

使用資源文件實現本地化，目前只做了中、英文。

資源文件如下：

指定默認區域性

要使資源文件可正常使用，應用程序必須指定 NeutralResourcesLanguage。在共享項目中，應自定義 AssemblyInfo.cs 文件以指定默認區域性。以下代碼演示如何在 AssemblyInfo.cs 文件中將 NeutralResourcesLanguage 設置為 zh-CN (摘自官方文檔：https://docs.microsoft.com/zh-cn/samples/xamarin/xamarin-forms-samples/usingresxlocalization/，后經測試，注釋下面這段代碼也能正常本地化)：

[assembly: NeutralResourcesLanguage("zh-Hans")]

XAML中使用

引入資源文件命名空間

xmlns:resources="clr-namespace:TerminalMACS.Clients.App.Resx"

具體使用如

3. 關于TerminalMACS及本客戶端

3.1. TermainMACS

多終端資源管理與檢測系統，包含多個子進程模塊，目前只開發了Xamarin.Forms客戶端，下一步開發服務端，使用 .NET 5 Web API開發，基于Abp vNext搭建。

3.2. Xamarin.Forms客戶端

作為TerminalMACS系統的一個子進程模塊，目前只開發了手機基本信息獲取、聯系人信息獲取、本地化功能，后續開發服務端時，會配合添加通信功能，比如連接服務端驗證、主動推送已獲取資源等。

3.3. 關于項目開源

開源項目地址：https://github.com/dotnet9/TerminalMACS

除非注明，文章均由?TerminalMACS?整理發布，歡迎轉載。

轉載請注明本文地址：https://terminalmacs.com/890.html

總結

以上是生活随笔為你收集整理的Xamarin.Forms客户端第一版的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。

上一篇： EntityFramework Core
下一篇：给 EF Core 查询增加 With