Настройки клиентского приложения
ClientLoader.exe устанавливаются в файле ClientLoader.exe.config в секции userSetting.Ultima.ClientProperties.Settings:
<userSettings> <Ultima.Client.Properties.Settings> <setting name="AuthMethod" serializeAs="String"> <value>Interactive</value> </setting> <setting name="Login" serializeAs="String"> <value>root</value> </setting> <setting name="Password" serializeAs="String"> <value>n/a</value> </setting> <setting name="AutomaticServerSelection" serializeAs="String"> <value>False</value> </setting> <setting name="ModuleCacheFolderName" serializeAs="String"> <value>ClientModules</value> </setting> <setting name="MapCacheFolder" serializeAs="String"> <value>MapCache</value> </setting> <setting name="ClientApplicationID" serializeAs="String"> <value>1</value> </setting> <setting name="UpdateModules" serializeAs="String"> <value>True</value> </setting> <setting name="DuplexProtocol" serializeAs="String"> <value>True</value> </setting> <setting name="ThreadingAlerts" serializeAs="String"> <value>True</value> </setting> <setting name="ScreenDpiCheckEnabled" serializeAs="String"> <value>True</value> </setting> <setting name="StartupCommands" serializeAs="String"> <value /> </setting> <setting name="ServerAddresses" serializeAs="Xml"> <value> <ArrayOfServerAddress xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema"> <ServerAddress> <Host>localhost</Host> <Port>8192</Port> <DuplexProtocol>true</DuplexProtocol> <Quality>1</Quality> </ServerAddress> </ArrayOfServerAddress> </value> </setting> </Ultima.Client.Properties.Settings> </userSettings> |
AuthMethod — выбирает метод авторизации пользователя при запуске приложения, имеет следующие значения:
•interactive — графический интерфейс ввода логина/пароля;
•automatic — полностью автоматический вход.
Login — логин, под которым осуществляется автоматический вход в приложение.
Password — пароль для автоматического входа.
AutomaticServerSelection — определяет возможность выбора пользователем при запуске приложения сервера приложений:
•true — пользователь не имеет возможности выбирать сервер приложений самостоятельно;
•false — пользователь имеет возможность выбирать сервер приложений самостоятельно.
ModuleCacheFolderName — папка, в которой сохраняются модули клиентского приложения.
MapCacheFolder — папка, используемая для хранения кэша карт.
ClientApplicationID — код клиентского приложения (перечень клиентских приложений хранится в базе данных). Стандартное клиентское приложение Windows Forms на базе модулей имеет код 1. Примерами других приложений могут быть терминал печати накладных, монитор выдачи и т. п. Для обычной разработки клиентских модулей эту настройку менять не нужно.
UpdateModules — загрузка модулей клиентского приложения, имеет следующие значения:
•true — при запуске клиентского приложения его модули загружаются с сервера приложений и сохраняются в папку, заданную параметром ModuleCacheFolderName;
•false — модули загружаются локально из папки, заданной параметром ModuleCacheFolderName.
DuplexProtocol — канал связи с сервером приложений, должен быть таким же, что и для сервера приложений, имеет следующие значения:
•true — используется дуплексный канал (рекомендуемое значение);
•false — используется стандартный канал .NET Remoting.
ThreadingAlerts — выдавать предупреждения при выполнении в клиентском приложении синхронных вызовов удаленных методов. Настройка полезна в первую очередь прикладным разработчикам и пользователям, работающим с тестовой версией конфигурации:
•true — выдавать предупреждения;
•false — не выдавать предупреждения.
ScreenDpiCheckEnabled —проверка DPI экрана при старте приложения.
•true — проверять настройки системы и прекращать работу при неподдерживаемых значениях DPI;
•false — пропустить проверку.
StartupCommands — список команд, выполняемых при старте клиентского приложения (GUID-ы команд модулей, перечисленные через запятую). В качестве команды, выполняемой при старте системы, может использоваться, к примеру, наиболее часто используемый журнал документов (или несколько таких журналов), окно приветствия или совет дня.
ServerAddresses — перечень серверов приложений, с которыми может работать клиентское приложение. Задается массивом ArrayOfServerAddress, который включает один или более элементов ServerAddress, имеющих следующие параметры:
•Host – IP-адрес сервера приложений;
•Port – порт сервера приложений;
•DuplexProtocol – канал связи с сервером приложений, аналогично описанному выше;
•Quality – вес, согласно которому вычисляется вероятность подключения клиентского модуля именно к этому серверу приложений, если их в массиве ArrayOfServerAddress более одного. Вероятность равна отношению веса данного сервера к сумме весов всех серверов вместе взятых.
Например, в массиве прописано три сервера приложений, у первых двух из которых параметр Quality равен "1", а у третьего "2". В этом случае клиентский модуль при подключении к серверу приложений с вероятностью 25% выберет один из двух первых серверов и с вероятностью 50% последний.
Для настройки компьютера, предназначенного для функционирования клиентского приложения, необходимо выполнить следующие действия: •установить на компьютер операционную систему семейства Windows; •установить платформу .NET Framework версии не ниже 4.6; •скопировать дистрибутив Client; •отредактировать файл конфигурации ClientLoader.exe.config. •запуск клиентского приложения настоятельно рекомендуется осуществлять через утилиту обновления ClientUpdater.exe. |