Zarządzanie przesyłaniem pakietów

Stwórz zgłoszenie pakietu lotu

Aby utworzyć zgłoszenie na lot pakietowy, postępuj zgodnie z następującymi krokami.

1. Jeśli jeszcze tego nie zrobiłeś, należy spełnić wymagania wstępne opisane w Tworzenie i zarządzanie przesyłkami za pomocą usług Microsoft Store, w tym skojarzenie aplikacji Azure AD z kontem Centrum partnerskiego oraz uzyskanie identyfikatora klienta i klucza. Musisz to zrobić tylko raz; po utworzeniu identyfikatora klienta i klucza możesz użyć ich ponownie za każdym razem, gdy musisz utworzyć nowy token dostępu usługi Azure AD.

2. uzyskaj token dostępu usługi Azure AD. Aby korzystać z metod w interfejsie API przesyłania sklepu Microsoft Store, należy przekazać ten token dostępu. Po uzyskaniu tokenu dostępu należy 60 minut używać go przed jego wygaśnięciem. Po wygaśnięciu tokenu można uzyskać nowy.

3. Utwórz zgłoszenie przesyłu lotu, wykonując następującą metodę w interfejsie API przesyłania Sklepu Microsoft. Ta metoda tworzy nowe zgłoszenie w toku, które jest kopią ostatniego opublikowanego zgłoszenia.

   POST https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/flights/{flightId}/submissions
   

   Treść odpowiedzi zawiera zasób przesyłki lotu zawierający identyfikator nowego przesłania, identyfikator URI sygnatury dostępu współdzielonego (SAS) do przesyłania jakichkolwiek pakietów w ramach przesyłki do usługi Azure Blob Storage oraz dane nowego przesłania (w tym wszystkie oferty i informacje o cenach).

   Uwaga / Notatka

   URI SAS zapewnia dostęp do bezpiecznego zasobu w usłudze Azure Storage bez konieczności używania kluczy kont. Aby uzyskać podstawowe informacje o identyfikatorach URI sygnatur dostępu współdzielonego (SAS) i ich użyciu z usługą Azure Blob Storage, zobacz "Sygnatury dostępu współdzielonego, część 1: Opis modelu SAS" i "Sygnatury dostępu współdzielonego, część 2: Tworzenie i używanie SAS z usługą Blob Storage".

4. Jeśli dodajesz nowe pakiety do przesłania, przygotuj pakiety i dodaj je do archiwum ZIP.

5. Popraw dane zgłoszenia lotu z wszelkimi wymaganymi zmianami dla nowego zgłoszenia i wykonaj poniższą metodę, aby zaktualizować zgłoszenie pakietu lotu.

   PUT https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/flights/{flightId}/submissions/{submissionId}
   

   Uwaga / Notatka

   Jeśli dodajesz nowe pakiety do przesłania, pamiętaj, aby zaktualizować dane zgłoszenia, tak aby odnosiły się do nazwy i ścieżki względnej tych plików w archiwum ZIP.

6. Jeśli dodajesz nowe pakiety do przesłania, prześlij archiwum ZIP do usługi Azure Blob Storage, korzystając z identyfikatora URI sygnatury dostępu współdzielonego, który został podany w treści odpowiedzi metody POST wywołanej wcześniej. Istnieją różne biblioteki platformy Azure, których można użyć do wykonania na różnych platformach, w tym:

   • biblioteka klienta usługi Azure Storage dla platformy .NET
   • zestaw SDK usługi Azure Storage dla języka Java
   • zestaw SDK usługi Azure Storage dla języka Python

   Poniższy przykład kodu w języku C# pokazuje, jak przekazać archiwum ZIP do usługi Azure Blob Storage przy użyciu klasy CloudBlockBlob w bibliotece klienta usługi Azure Storage dla platformy .NET. W tym przykładzie przyjęto założenie, że archiwum ZIP zostało już zapisane w obiekcie strumienia.

   string sasUrl = "https://productingestionbin1.blob.core.windows.net/ingestion/26920f66-b592-4439-9a9d-fb0f014902ec?sv=2014-02-14&sr=b&sig=usAN0kNFNnYE2tGQBI%2BARQWejX1Guiz7hdFtRhyK%2Bog%3D&se=2016-06-17T20:45:51Z&sp=rwl";
   Microsoft.WindowsAzure.Storage.Blob.CloudBlockBlob blockBob =
       new Microsoft.WindowsAzure.Storage.Blob.CloudBlockBlob(new System.Uri(sasUrl));
   await blockBob.UploadFromStreamAsync(stream);
   

7. Zatwierdź przesłanie pakietu testowego, wykonując następującą procedurę. To powiadomi Centrum partnerskie, że zakończyłeś przesyłanie i że aktualizacje powinny teraz zostać zastosowane do Twojego konta.

   POST https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/flights/{flightId}/submissions/{submissionId}/commit
   

8. Sprawdź stan zatwierdzenia, wykonując następującą metodę, aby uzyskać stan przesyłania pakietu.

   GET https://manage.devcenter.microsoft.com/v1.0/my/applications/{applicationId}/flights/{flightId}/submissions/{submissionId}/status
   

   Aby potwierdzić status zgłoszenia, sprawdź wartość statusu w treści odpowiedzi. Ta wartość powinna ulec zmianie z CommitStarted na PreProcessing, jeśli żądanie zakończy się powodzeniem, lub na CommitFailed, jeśli występują błędy w żądaniu. Jeśli występują błędy, pole statusDetails zawiera dodatkowe szczegóły dotyczące błędu.

9. Po pomyślnym zakończeniu zatwierdzenia przesyłka jest wysyłana do Sklepu do przetwarzania. Postęp przesyłania można nadal monitorować przy użyciu poprzedniej metody lub odwiedzając Centrum partnerskie.

{
  "id": "1152921504621243649",
  "flightId": "cd2e368a-0da5-4026-9f34-0e7934bc6f23",
  "status": "PendingCommit",
  "statusDetails": {
    "errors": [],
    "warnings": [],
    "certificationReports": []
  },
  "flightPackages": [
    {
      "fileName": "newPackage.appx",
      "fileStatus": "PendingUpload",
      "id": "",
      "version": "1.0.0.0",
      "languages": ["en-us"],
      "capabilities": [],
      "minimumDirectXVersion": "None",
      "minimumSystemRam": "None"
    }
  ],
  "packageDeliveryOptions": {
    "packageRollout": {
        "isPackageRollout": false,
        "packageRolloutPercentage": 0.0,
        "packageRolloutStatus": "PackageRolloutNotStarted",
        "fallbackSubmissionId": "0"
    },
    "isMandatoryUpdate": false,
    "mandatoryUpdateEffectiveDate": "1601-01-01T00:00:00.0000000Z"
  },
  "fileUploadUrl": "https://productingestionbin1.blob.core.windows.net/ingestion/8b389577-5d5e-4cbe-a744-1ff2e97a9eb8?sv=2014-02-14&sr=b&sig=wgMCQPjPDkuuxNLkeG35rfHaMToebCxBNMPw7WABdXU%3D&se=2016-06-17T21:29:44Z&sp=rwl",
  "targetPublishMode": "Immediate",
  "targetPublishDate": "",
  "notesForCertification": "No special steps are required for certification of this app."
}

{
  "flightPackages": [
    {
      "fileName": "newPackage.appx",
      "fileStatus": "PendingUpload",
      "id": "",
      "version": "1.0.0.0",
      "languages": ["en-us"],
      "capabilities": [],
      "minimumDirectXVersion": "None",
      "minimumSystemRam": "None"
    }
  ],
}

{
  "packageDeliveryOptions": {
    "packageRollout": {
        "isPackageRollout": false,
        "packageRolloutPercentage": 0.0,
        "packageRolloutStatus": "PackageRolloutNotStarted",
        "fallbackSubmissionId": "0"
    },
    "isMandatoryUpdate": false,
    "mandatoryUpdateEffectiveDate": "1601-01-01T00:00:00.0000000Z"
  },
}