앱 패키지 매니페스트 정보 쿼리(C++)

아티클
06/12/2023

패키징 API를 사용하여 Windows 앱에 대한 앱 패키지 매니페스트에서 정보를 가져오는 방법을 알아봅니다.

패키지 매니페스트 판독기 만들기

패키지 매니페스트 판독기를 만들려면 IAppxFactory::CreatePackageReader 를 호출하여 패키지 판독기를 만듭니다. 첫 번째 매개 변수는 패키지(.appx 파일)에 대한 입력 스트림입니다. 두 번째 매개 변수는 IAppxPackageReader 포인터에 대한 포인터를 수신하는 출력 매개 변수입니다. 다음으로, IAppxPackageReader::GetManifest 를 호출하여 매니페스트 판독기를 가져옵니다. 매개 변수는 IAppxManifestReader 포인터에 대한 포인터를 수신하는 출력 매개 변수입니다.

int wmain(
    _In_ int argc,
    _In_reads_(argc) wchar_t** argv)
{
    HRESULT hr = S_OK;
 
    if (argc != 2)
    {
        wprintf(L"Usage: DescribeAppx.exe inputFile\n");
        wprintf(L"       inputFile: Path to the app package to read\n");
        return 2;
    }

    // Specify the appropriate COM threading model
    hr = CoInitializeEx(NULL, COINIT_MULTITHREADED);

    if (SUCCEEDED(hr))
    {
        IAppxPackageReader* packageReader = NULL;
        IAppxManifestReader* manifestReader = NULL;

        // Create a package reader using the file name given in command line
        hr = GetPackageReader(argv[1], &packageReader);

        // Get manifest reader for the package and read from the manifest
        if (SUCCEEDED(hr))
        {
            hr = packageReader->GetManifest(&manifestReader);
        }
        if (SUCCEEDED(hr))
        {
            hr = ReadManifest(manifestReader);
        }
    }
}

//
// Creates an app package reader.
//
// Parameters:
//   inputFileName 
//     Fully qualified name of the app package (.appx file) to be opened.
//   reader 
//     On success, receives the created instance of IAppxPackageReader.
//
HRESULT GetPackageReader(
    _In_ LPCWSTR inputFileName,
    _Outptr_ IAppxPackageReader** reader)
{
    HRESULT hr = S_OK;
    IAppxFactory* appxFactory = NULL;
    IStream* inputStream = NULL;

    // Create a new factory
    hr = CoCreateInstance(
            __uuidof(AppxFactory),
            NULL,
            CLSCTX_INPROC_SERVER,
            __uuidof(IAppxFactory),
            (LPVOID*)(&appxFactory));

    // Create a stream over the input app package
    if (SUCCEEDED(hr))
    {
        hr = SHCreateStreamOnFileEx(
                inputFileName,
                STGM_READ | STGM_SHARE_EXCLUSIVE,
                0, // default file attributes
                FALSE, // do not create new file
                NULL, // no template
                &inputStream);
    }

    // Create a new package reader using the factory.  For 
    // simplicity, we don't verify the digital signature of the package.
    if (SUCCEEDED(hr))
    {
        hr = appxFactory->CreatePackageReader(
                inputStream,
                reader);
    }

    // Clean up allocated resources
    if (inputStream != NULL)
    {
        inputStream->Release();
        inputStream = NULL;
    }
    if (appxFactory != NULL)
    {
        appxFactory->Release();
        appxFactory = NULL;
    }
    return hr;
}

패키지 ID 정보 읽기

패키지 식별은 매니페스트의 Identity 요소를 사용하여 지정됩니다. 여기에 표시된 대로 IAppxManifestReader::GetPackageId 를 사용하여 IAppxManifestPackageId 를 가져와 패키지 ID 정보를 읽습니다.

이 코드는 IAppxManifestPackageId::GetPackageFullName 을 사용하여 패키지 전체 이름을 가져옵니다. IAppxManifestPackageId::GetName 은 패키지 이름을, IAppxManifestPackageId::GetVersion 은 패키지 버전을 가져옵니다.

//
// Reads a subset of the manifest Identity element.
//
//
HRESULT ReadManifestPackageId(
    _In_ IAppxManifestReader* manifestReader)
{
    HRESULT hr = S_OK;

    IAppxManifestPackageId* packageId = NULL;

    // Get elements and attributes from the manifest reader
    hr = manifestReader->GetPackageId(&packageId);
    if (SUCCEEDED(hr))
    {
        LPWSTR packageFullName = NULL;
        LPWSTR packageName = NULL;
        UINT64 packageVersion = 0;

        hr = packageId->GetPackageFullName(&packageFullName);

        if (SUCCEEDED(hr))
        {
            hr = packageId->GetName(&packageName);
        }
        if (SUCCEEDED(hr))
        {
            hr = packageId->GetVersion(&packageVersion);
        }
        if (SUCCEEDED(hr))
        {
            wprintf(L"Package full name: %s\n", packageFullName);
            wprintf(L"Package name: %s\n", packageName);
            wprintf(L"Package version: ");

            // Convert version number from 64-bit integer to dot-quad form
            for (int bitPosition = 0x30; bitPosition >= 0; bitPosition -= 0x10)
            {
                UINT64 versionWord = (packageVersion >> bitPosition) & 0xFFFF;
                wprintf(L"%llu.", versionWord);
            }
            wprintf(L"\n");
        }

        // Free all string buffers returned from the manifest API
        CoTaskMemFree(packageFullName);
        CoTaskMemFree(packageName);
    }

    // Clean up allocated resources
    if (packageId != NULL)
    {
        packageId->Release();
        packageId = NULL;
    }
     
    return hr;
}

사용자에게 패키지를 설명하는 메타데이터 읽기

속성은 매니페스트의 Properties 요소를 사용하여 지정됩니다. 여기에 표시된 대로 IAppxManifestReader::GetProperties 를 사용하여 IAppxManifestProperties 를 가져와 이 노드를 읽습니다.

이 코드는 IAppxManifestProperties::GetStringValue를 사용하여 패키지 표시 이름 및 패키지 설명을 가져옵니다.

//
// Reads a subset of the manifest Properties element.
//
//
HRESULT ReadManifestProperties(
    _In_ IAppxManifestReader* manifestReader)
{
    HRESULT hr = S_OK;

    IAppxManifestProperties* properties = NULL;

    // Get elements and attributes from the manifest reader
    hr = manifestReader->GetProperties(&properties);
    if (SUCCEEDED(hr))
    {
        LPWSTR displayName = NULL;
        LPWSTR description = NULL;

        hr = properties->GetStringValue(L"DisplayName", &displayName);

        if (SUCCEEDED(hr))
        {
            hr = properties->GetStringValue(L"Description", &description);
        }
        if (SUCCEEDED(hr))
        {
            wprintf(L"Package display name: %s\n", displayName);
            wprintf(L"Package description:  %s\n", description);
        }

        // Free all string buffers returned from the manifest API
        CoTaskMemFree(displayName);
        CoTaskMemFree(description);
    }
    // Clean up allocated resources
    if (properties != NULL)
    {
        properties->Release();
        properties = NULL;
    }

    return hr;
}

패키지에 포함된 앱에 대한 메타데이터 읽기

앱은 매니페스트의 Applications 요소를 사용하여 지정됩니다. IAppxManifestReader::GetApplications를 사용하여 IAppxManifestApplicationsEnumerator를 가져와 이 노드를 읽습니다. IAppxManifestApplicationsEnumerator::GetCurrent 및 IAppxManifestApplicationsEnumerator::MoveNext를 사용하여 패키지의 각 앱에 대한 IAppxManifestApplication을 가져옵니다.

이 코드는 IAppxManifestApplication::GetStringValue를 사용하여 각 앱의 표시 이름을 가져옵니다.

//
// Reads a subset of the manifest Applications element.
//
//
HRESULT ReadManifestApplications(
    _In_ IAppxManifestReader* manifestReader)
{
    HRESULT hr = S_OK;
    BOOL hasCurrent = FALSE;
    UINT32 applicationsCount = 0;

    IAppxManifestApplicationsEnumerator* applications = NULL;

    // Get elements and attributes from the manifest reader
    hr = manifestReader->GetApplications(&applications);
    if (SUCCEEDED(hr))
    {
        hr = applications->GetHasCurrent(&hasCurrent);

        while (SUCCEEDED(hr) && hasCurrent)
        {
            IAppxManifestApplication* application = NULL;
            LPWSTR applicationName = NULL;

            hr = applications->GetCurrent(&application);
            if (SUCCEEDED(hr))
            {
                application->GetStringValue(L"DisplayName", &applicationName);
            }
            if (SUCCEEDED(hr))
            {
                applicationsCount++;
                wprintf(L"App #%u: %s\n", applicationsCount, applicationName);
            }

            if (SUCCEEDED(hr))
            {
                hr = applications->MoveNext(&hasCurrent);
            }
            if (application != NULL)
            {
                application->Release();
                application = NULL;
            }
            CoTaskMemFree(applicationName);
        }

        wprintf(L"Count of apps in the package: %u\n", applicationsCount);
    }

    // Clean up allocated resources
    if (applications != NULL)
    {
        applications->Release();
        applications = NULL;
    }

    return hr;
}

패키지 매니페스트 판독기 정리

함수에서 wmain 반환하기 전에 Release 메서드를 호출하여 패키지 매니페스트 판독기를 클린 CoUninitialize 함수를 호출합니다.

// Clean up allocated resources
if (manifestReader != NULL)
{
    manifestReader->Release();
    manifestReader = NULL;
}
if (packageReader != NULL)
{
    packageReader->Release();
    packageReader = NULL;
}

CoUninitialize();

샘플
앱 패키지 및 앱 매니페스트 샘플 쿼리
참조
IAppxManifestReader

다음을 통해 공유

앱 패키지 매니페스트 정보 쿼리(C++)

패키지 매니페스트 판독기 만들기

패키지 ID 정보 읽기

사용자에게 패키지를 설명하는 메타데이터 읽기

패키지에 포함된 앱에 대한 메타데이터 읽기

패키지 매니페스트 판독기 정리

피드백

추가 리소스

다음을 통해 공유

앱 패키지 매니페스트 정보 쿼리(C++)

패키지 매니페스트 판독기 만들기

패키지 ID 정보 읽기

사용자에게 패키지를 설명하는 메타데이터 읽기

패키지에 포함된 앱에 대한 메타데이터 읽기

패키지 매니페스트 판독기 정리

관련 항목

피드백

추가 리소스