qohosabilitycontext_p.h

Go to the documentation of this file.

// 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
 
#ifndef QOHOSABILITYCONTEXT_P_H
#define QOHOSABILITYCONTEXT_P_H
 
//
//  W A R N I N G
//  -------------
//
// This file is not part of the Qt API.  It exists purely as an
// implementation detail.  This header file may change from version to
// version without notice, or even be removed.
//
// We mean it.
//
 
#include <QtCore/qbytearray.h>
#include <QtCore/qlist.h>
#include <QtCore/qstring.h>
#include <QtCore/qjsonobject.h>
#include <QtGui/qwindow.h>
#include <QtOhosAppKit/private/qohosoperationstatus_p.h>
#include <QtOhosAppKit/private/qohoswant_p.h>
#include <QtOhosAppKit/private/qohosstartoptions_p.h>
#include <QtOhosAppKit/private/qtohosappkitglobal_p.h>
#include <QtOhosAppKit/private/qohossharekit_p.h>
#include <QtWidgets/qwidget.h>
#include <functional>
#include <memory>
#include <optional>
 
QT_BEGIN_NAMESPACE
 
namespace QtOhosAppKit {
 
class Q_OHOSAPPKIT_EXPORT OpenLinkOptions
{
public:
    virtual ~OpenLinkOptions();
 
    virtual void setAppLinkingOnly(bool appLinkingOnly) = 0;
 
protected:
    OpenLinkOptions();
 
private:
    Q_DISABLE_COPY(OpenLinkOptions)
};
 
Q_OHOSAPPKIT_EXPORT std::shared_ptr<OpenLinkOptions> createOpenLinkOptions();
 
class Q_OHOSAPPKIT_EXPORT OnContinueContext
{
public:
    virtual ~OnContinueContext();
 
    virtual void setAgreeResponse(const QByteArray &responseData) = 0;
    virtual void setRejectResponse() = 0;
    virtual void setMismatchResponse() = 0;
 
    virtual void setExitAppOnSourceDeviceAfterMigration(bool exitAfterMigration) = 0;
 
    virtual int sourceApplicationVersionCode() const = 0;
 
protected:
    OnContinueContext();
 
private:
    Q_DISABLE_COPY(OnContinueContext)
};
 
struct StartAbilityResult
{
    int resultCode = 0;
    std::optional<Want> want;
};
 
class Q_OHOSAPPKIT_EXPORT AbilityContext : public QObject
{
    Q_OBJECT
 
public:
    static std::shared_ptr<AbilityContext> defaultInstance();
    static std::shared_ptr<AbilityContext> instanceForMainWindow(QWindow *instanceMainWindow);
 
    virtual void setDestroyFromSystemEnabled(bool destroyEnabled) = 0;
 
    virtual void startAbilityForResult(
        const Want &want, std::shared_ptr<StartOptions> options, QObject *context,
        std::function<void(std::optional<StartAbilityResult>)> callback) = 0;
 
    virtual void shareDataWithShareKit(
        const QList<std::shared_ptr<ShareKit::SharedRecord>> &records,
        std::shared_ptr<ShareKit::ShareControllerOptions> controllerOptions,
        QObject *context,
        std::function<void(std::shared_ptr<ShareKit::ShareOperationResult>)> onShareCompleted,
        std::function<void()> onPanelClosed) = 0;
 
    virtual bool tryOpenLink(const QString &link, std::shared_ptr<OpenLinkOptions> options) = 0;
 
    virtual void setContinuationActive(bool continuationActive) = 0;
 
Q_SIGNALS:
    void newWantInfoReceived(std::shared_ptr<WantInfo> wantInfo);
    void continueRequestReceived(std::shared_ptr<OnContinueContext> onContinueContext);
 
protected:
    AbilityContext();
 
    Q_DISABLE_COPY(AbilityContext)
};
 
Q_OHOSAPPKIT_EXPORT std::shared_ptr<OperationStatus> startAbility(const Want &want, std::shared_ptr<StartOptions> options = nullptr);
 
Q_OHOSAPPKIT_EXPORT std::shared_ptr<OperationStatus> startAbilityByType(const QString &appType, const QJsonObject &wantParameters);
 
Q_OHOSAPPKIT_EXPORT void startNewAbilityInstance(QWidget *instanceWidget);
 
Q_OHOSAPPKIT_EXPORT void startAppProcess(const QString &processId, const Want &requestWant, std::shared_ptr<StartOptions> options = nullptr);
 
Q_OHOSAPPKIT_EXPORT void setAbilityInstanceDestroyEnabled(QWindow *instanceWindow, bool destroyEnabled);
 
Q_OHOSAPPKIT_EXPORT std::optional<QByteArray> tryGetOnContinueData(const Want &want);
 
}
 
QT_END_NAMESPACE
 
#endif // QOHOSABILITYCONTEXT_P_H