Revision control
Copy as Markdown
// Copyright (C) 2026 The Qt Company Ltd.
// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR LGPL-3.0-only OR GPL-2.0-only OR GPL-3.0-only
#include "qohoswant_p.h"
QT_BEGIN_NAMESPACE
namespace QtHarmonyExtras {
/*!
\enum QtHarmonyExtras::WantFlag
\since 5.12.12
WantFlag specifies how the Want will be handled.
{Flags}.
\value AuthReadUriPermission Grants the permission to read the URI.
\value AuthWriteUriPermission Grants the permission to write data to the URI.
\value InstallOnDemand Ability will be installed if it has not been installed.
*/
/*!
\class QtHarmonyExtras::Want
\inmodule QtHarmonyExtras
\since 5.12.12
\brief Want wraps Ohos \l {https://developer.huawei.com/consumer/en/doc/harmonyos-guides-V5/want-V5}
{Want} class.
It keeps information that can be transmitted between applications. One of the usage scenarios of
Want is a parameter of starting an ability or starting application process.
\sa startAbility()
\sa startAppProcess()
*/
/*!
\variable QtHarmonyExtras::Want::deviceId
\brief Represents the device Id on which Ability is to be performed.
See \l {https://developer.huawei.com/consumer/en/doc/harmonyos-references-V5/js-apis-app-ability-want-V5}
{Device Id}.
*/
/*!
\variable QtHarmonyExtras::Want::bundleName
\brief Represents an application bundle name.
See \l {https://developer.huawei.com/consumer/en/doc/harmonyos-references-V5/js-apis-app-ability-want-V5}
{Bundle Name}.
*/
/*!
\variable QtHarmonyExtras::Want::moduleName
\brief Represents the module name.
See \l {https://developer.huawei.com/consumer/en/doc/harmonyos-references-V5/js-apis-app-ability-want-V5}
{Module Name}.
*/
/*!
\variable QtHarmonyExtras::Want::abilityName
\brief Represents the name of Ability to be started.
See \l {https://developer.huawei.com/consumer/en/doc/harmonyos-references-V5/js-apis-app-ability-want-V5}
{Ability Name}.
*/
/*!
\variable QtHarmonyExtras::Want::uri
\brief Represents the type of pending data.
See \l {https://developer.huawei.com/consumer/en/doc/harmonyos-references-V5/js-apis-app-ability-want-V5}
{Uri}.
*/
/*!
\variable QtHarmonyExtras::Want::type
\brief Represents the MIME type of the file to open for example 'text/xml', 'image/ * ', etc.
See \l {https://developer.huawei.com/consumer/en/doc/harmonyos-references-V5/js-apis-app-ability-want-V5}
{Type}.
*/
/*!
\variable QtHarmonyExtras::Want::action
\brief Represents the general operations to be performed, for example: viewing, sharing,
application details.
See \l {https://developer.huawei.com/consumer/en/doc/harmonyos-references-V5/js-apis-app-ability-want-V5}
{Action}.
*/
/*!
\variable QtHarmonyExtras::Want::entities
\brief Represents the additional category information of the target Ability for example:
browser, video player.
See \l {https://developer.huawei.com/consumer/en/doc/harmonyos-references-V5/js-apis-app-ability-want-V5}
{Entities}.
*/
/*!
\variable QtHarmonyExtras::Want::flags
\brief Represents the way to deal with Want.
See \l {https://developer.huawei.com/consumer/en/doc/harmonyos-references-V5/js-apis-app-ability-want-V5}
{Flags}.
\sa WantFlag
*/
/*!
\variable QtHarmonyExtras::Want::parameters
\brief Represents the list of parameters in the Want object.
See \l {https://developer.huawei.com/consumer/en/doc/harmonyos-references-V5/js-apis-app-ability-want-V5}
{Parameters}.
*/
/*!
\variable QtHarmonyExtras::Want::fds
\brief Represents the file descriptor map in the Want object.
When serialized for startAbility(), each entry is passed to the platform
using the fixed HarmonyOS file descriptor parameter format:
\code
parameters[key] = { "type": "FD", "value": fd }
\endcode
Use application-specific keys, for example a reverse-DNS prefix, and avoid
using the same key in both fds and parameters.
{Fds}.
*/
/*!
\class QtHarmonyExtras::WantInfo
\inmodule QtHarmonyExtras
\since 5.12.12
\brief The WantInfo class is to represent Ohos want type.
*/
/*!
\class QtHarmonyExtras::WantInfo::ContactInfo
\brief The ContactInfo struct represents contact information extracted from a Want.
This struct is used to hold the contact type and contact ID when the application
is launched to handle a contact-related action.
*/
/*!
\fn QtHarmonyExtras::Want QtHarmonyExtras::WantInfo::want() const = 0;
Return associated with this instance Want object.
*/
/*!
\fn virtual std::optional<QList<std::shared_ptr<QtHarmonyExtras::ShareKit::SharedRecord>>> QtHarmonyExtras::WantInfo::tryGetSharedRecordsFromShareKit() const = 0
Tries to get shared records from assosiated want. The shared data is expected to be stored in the want parameters.
Shared records are delivered on an application start or while the application is already running. Returns an empty optional if no such data found.
{systemShare.getSharedData}.
\sa QtHarmonyExtras::AbilityContext::newWantInfoReceived(std::shared_ptr<QtHarmonyExtras::WantInfo> wantInfo)
\sa std::shared_ptr<QtHarmonyExtras::WantInfo>, QtHarmonyExtras::AppContext::appLaunchWantInfo()
*/
/*!
\fn virtual std::optional<QtHarmonyExtras::WantInfo::ContactInfo> QtHarmonyExtras::WantInfo::tryGetContactInfo() const = 0
Tries to get contact information from the associated Want. Returns an empty optional if no
contact information is found.
{systemShare.getContactInfo}.
\sa QtHarmonyExtras::AbilityContext::newWantInfoReceived(std::shared_ptr<QtHarmonyExtras::WantInfo> wantInfo)
\sa std::shared_ptr<QtHarmonyExtras::WantInfo>, QtHarmonyExtras::AppContext::appLaunchWantInfo()
*/
WantInfo::WantInfo() = default;
WantInfo::~WantInfo() = default;
}
QT_END_NAMESPACE