Często zadawane pytania dotyczące przesyłania w usłudze Microsoft AppSource

Ten artykuł zawiera odpowiedzi na często zadawane pytania dotyczące przesyłania aplikacji do usługi Microsoft AppSource za pośrednictwem Centrum partnerskiego.

Aby uzyskać najnowszą wersję zasad certyfikacji, zobacz Zasady certyfikacji.

Ostrzeżenie

Dodatki programu SharePoint zostały przestarzałe i nie są już obsługiwane. Istniejące dodatki programu SharePoint będą nadal działać, ale żadne nowe dodatki programu SharePoint nie mogą być przesyłane do usługi Microsoft AppSource. Aby uzyskać więcej informacji, zobacz Dodatki programu SharePoint. Rozwiązania programu SharePoint są nadal obsługiwane. Aby uzyskać więcej informacji, zobacz Rozwiązania programu SharePoint.

Jak uniknąć błędów podczas przesyłania aplikacji do usługi Microsoft AppSource?

Aby uniknąć typowych błędów przesyłania:

  • Upewnij się, że numer wersji w formularzu przesyłania jest zgodny z numerem wersji w manifeście aplikacji.

    Uwaga

    Określ wersję aplikacji przy użyciu następującej składni: . b. c. d gdzie a jest liczbą całkowitą z zakresu od 1 do 9999, a każda z b , c , d jest liczbą całkowitą z zakresu od 0 do 9999. Przykłady: 1.0.0.0, 6.23.0.1.

  • Upewnij się, że wszystkie lokalizacje są zabezpieczone protokołem SSL (HTTPS).

  • Upewnij się, że w manifeście określono ikonę i że ikona ma prawidłowy rozmiar i sformatowany.

  • Upewnij się, że twój identyfikator jest unikatowy. Na przykład nie twórz manifestu dla drugiego dodatku opartego na innym przesłanym manifeście dodatku bez zmiany identyfikatora w nowym manifeście.

  • W przypadku dodatków pakietu Office upewnij się, że używasz schematu manifestu w wersji 1.1. Aby uzyskać informacje na temat aktualizowania manifestu do wersji 1.1, zobacz Aktualizowanie do najnowszej biblioteki interfejsu API języka JavaScript dla pakietu Office i schemat manifestu dodatku w wersji 1.1.

  • W przypadku dodatków pakietu Office upewnij się, że w manifeście określono adres URL pomocy technicznej. Jeśli używasz manifestu XML, ustaw wartość elementu SupportUrl. Jeśli używasz ujednoliconego manifestu dla platformy Microsoft 365, użyj właściwości developer.websiteUrl. Adres URL pomocy technicznej powinien być publicznie dostępną stroną internetową i nie powinien wymagać uwierzytelniania. Nie można używać osobistych stron mediów społecznościowych ani repozytoriów GitHub dla adresu URL pomocy technicznej. Nie można również używać linków do plików hostowanych w trybie online, takich jak dokument programu Word w usłudze OneDrive, DropBox lub Google Docs.

  • W przypadku wszystkich aplikacji upewnij się, że manifest jest prawidłowy względem schematu. Aby uzyskać informacje o walidacji schematu, zobacz Dokumentacja schematu manifestów dodatków pakietu Office (wersja 1.1) lub Dokumentacja schematu dla manifestów rozwiązań programu SharePoint.

  • Upewnij się, że aplikacja jest przetestowana i jest w pełni funkcjonalna.

  • Upewnij się, że rozwiązania programu SharePoint określają obsługiwane ustawienia regionalne.

    Jeśli nie określisz obsługiwanych ustawień regionalnych, aplikacja nie zostanie zaakceptowana przez usługę Microsoft AppSource. Aby uzyskać szczegółowe informacje, zobacz Informacje o obsłudze ustawień regionalnych są wymagane dla wszystkich dodatków.

  • Upewnij się, że przesyłasz link prywatności.

  • Upewnij się, że wszystkie przesyłane linki wideo rzeczywiście przechodzą do pliku wideo lub strony zawierającej wideo.

  • Jeśli dodatek pakietu Office jest dostępny w systemie iOS, nie dołączaj "aplikacji" do tytułu dodatku ani krótkiego opisu dodatku.

Jeśli wprowadzam aktualizacje do przesyłania, kiedy muszę przesłać ją ponownie do usługi Microsoft AppSource?

Jeśli wprowadzisz aktualizacje usługi internetowej dla aplikacji, nie musisz jej ponownie przesyłać. Jeśli jednak wprowadzisz zmiany w dowolnych elementach lub danych przesłanych za pośrednictwem Centrum partnerskiego, takich jak manifest, zrzuty ekranu lub ikona, musisz przesłać je ponownie, aby usługa Microsoft AppSource mogła zaimplementować te zmiany. Należy ponownie przesłać aplikacje ze zaktualizowanym manifestem zawierającym nowy numer wersji. Należy również zaktualizować numer wersji w formularzu przesyłania, aby był zgodny z numerem wersji nowego manifestu.

Co się stanie, gdy zaktualizuję aplikację do nowej wersji w usłudze Microsoft AppSource?

Poniżej przedstawiono proces aktualizacji dodatków pakietu Office.

  • Prześlij poprawiony manifest dodatku i dodatku do usługi Microsoft AppSource za pośrednictwem Centrum partnerskiego. Poprawiony dodatek przechodzi przez proces weryfikacji, a po zatwierdzeniu jest udostępniany w usłudze Microsoft AppSource.

    Ważne

    Jeśli przesyłanie jest aktualizacją i zaplanowano dostępność aplikacji do daty w przyszłości, istniejąca aplikacja zostanie wycofana z usługi Microsoft AppSource do określonej daty wydania.

  • Możesz nadal oferować poprzednią wersję aplikacji w usłudze Microsoft AppSource lub anulować publikowanie poprzedniej wersji.

  • Gdy istniejący klient uruchamia zaktualizowaną aplikację po raz pierwszy, w okienku zadań lub w treści dokumentu z monitem użytkownika o zaktualizowanie aplikacji zostanie wyświetlone powiadomienie. Gdy użytkownik wybierze pozycję Aktualizuj, zostanie uruchomiona najnowsza wersja aplikacji.

    Uwaga

    Powiadomienie o aktualizacji dotyczy tylko programów Excel, PowerPoint i Word. Nie ma zastosowania do programu Outlook.

Jeśli zaktualizowana wersja zawiera nowe uprawnienia, użytkownik musi wyrazić na nie zgodę.

Uwaga

Nie można jednocześnie mieć co najmniej dwóch wersji tej samej aplikacji w usłudze Microsoft AppSource, ponieważ każda aplikacja ma unikatowy identyfikator zasobu. Jeśli opublikujesz zaktualizowaną wersję aplikacji bez publikowania poprzedniej wersji, będziesz mieć dwie listy i potencjalnie podzielić bazę klientów.

Aktualizacje dodatków programu SharePoint za pośrednictwem Centrum partnerskiego nie są już obsługiwane. Aby uzyskać więcej informacji na temat aktualizowania dodatków programu SharePoint poza Centrum partnerskim, zobacz Proces aktualizacji dodatków programu SharePoint.

Czy mogę przesłać płatną aplikację do usługi Microsoft AppSource?

Wszystkie aplikacje przesłane do usługi Microsoft AppSource za pośrednictwem Centrum partnerskiego są bezpłatne. Aplikację można zarabiać za pośrednictwem komercyjnej platformy handlowej firmy Microsoft; Aby uzyskać szczegółowe informacje, zobacz Monetize your add-in (Zarabianie na dodatku).

Jak otrzymywać powiadomienia o stanie publikowania lub wymaganych akcjach?

Po opublikowaniu oferty właściciel konta dewelopera jest powiadamiany o stanie publikowania i wymaganych akcjach za pośrednictwem poczty e-mail i Centrum akcji w Centrum partnerskim. Aby uzyskać więcej informacji na temat Centrum akcji, zobacz Centrum akcji — omówienie.

Jak mogę odwołać się do interfejsów API języka JavaScript dla pakietu Office w moich aplikacjach?

Jeśli aplikacja używa interfejsów API języka JavaScript dla pakietu Office, musisz odwołać się do pliku Office.js hostowanego przez firmę Microsoft z adresu URL usługi CDN. Nie dołączaj kopii pliku Office.js w aplikacji ani nie odwołuj się do kopii pliku hostowanego gdzie indziej.

Dlaczego moje aplikacje muszą być zabezpieczone za pomocą protokołu SSL?

Aplikacje, które nie są zabezpieczone protokołem SSL (HTTPS), generują niezabezpieczone ostrzeżenia i błędy zawartości podczas używania. Z tego powodu wszystkie aplikacje przesłane do usługi Microsoft AppSource muszą być zabezpieczone za pomocą protokołu SSL.

Jak mogę zadeklarować obsługę języka?

Dwa aspekty przesyłania odnoszą się do obsługiwanych języków:

  1. Języki zadeklarowane w pakiecie aplikacji lub manifeście. Zadeklaruj języki obsługiwane przez aplikację w zależności od typu:

    • W przypadku dodatków pakietu Office, które nie są słownikami, zadeklaruj obsługę języka przy użyciu elementów DefaultLocale i Override w manifeście. Aby uzyskać więcej informacji, zobacz Lokalizacja dodatków pakietu Office.

    • W przypadku dodatków pakietu Office, które są słownikami, można również użyć elementu TargetDialects w manifeście dodatku.

  2. W Centrum partnerskim możesz wybrać języki na stronie Listy sklepów .

    Uwaga

    Możesz zadeklarować więcej języków w pakiecie aplikacji, niż są dostępne do przesłania w Centrum partnerskim.

Jeśli moja aplikacja jest przeznaczona dla przedsiębiorstw, jak to wpływa na moje przesyłanie?

Niektóre wymagania są wyłączane lub zmieniane, jeśli aplikacja lub dodatek jest przeznaczona tylko dla większych organizacji i przedsiębiorstw i nie jest przeznaczona dla platformy handlowej. Obowiązują wszystkie inne wymagania dotyczące zasad platformy handlowej. W poniższej tabeli przedstawiono kluczowe różnice.

Zachowanie Komercyjna aplikacja platformy handlowej Aplikacja jest przeznaczona tylko dla większych organizacji i przedsiębiorstw Powiązane zasady komercyjnej platformy handlowej
Strony główne usługi AppSource Może pojawić się na stronach główne specyficznych dla aplikacji w usłudze AppSource i będzie można je odnaleźć za pośrednictwem wyszukiwania i dostępnego dla kampanii internetowych i e-mail. Nie będzie wyświetlana na stronach głównej, ale będzie można je odnaleźć za pośrednictwem wyszukiwania i dostępnego dla kampanii internetowych i e-mail. Nie dotyczy
Nazwa marki lub usługi Tytuł nie może zawierać nazwy marki ani usługi. Tytuł może zawierać nazwę marki lub usługi, zwłaszcza jeśli pomaga przekazać cel dodatku lub aplikacji. 1100.7
Bezproblemowe środowisko pierwszego uruchomienia Wymagany. Musi zapewnić bezproblemowe środowisko pierwszego uruchomienia, które wyraźnie wyjaśnia, jak z niego korzystać. Na przykład na ekranie startowym dodatku opisz jego funkcjonalność i korzyści w kilku wierszach. Ponadto jeśli użytkownicy muszą się zarejestrować lub zalogować, aby korzystać z aplikacji, przed zarejestrowaniem się należy wyjaśnić, że konto lub usługa ma to konto. Nie jest to wymagane, ale zamiast tego musi zawierać kontakt e-mail lub link do witryny internetowej, aby użytkownicy mogli dowiedzieć się więcej o usługach. 1100.5
Środowisko logowania/wylogowywanie Tylko dodatki: wymagane, jeśli dodatek wymaga zewnętrznych kont lub usług, w tym przypadku należy podać link logowania dla każdego z nich i link wylogowania, gdy użytkownik się zalogował. W przeciwnym razie nie jest to wymagane. Tylko dodatki: wymagane, chyba że dodatek wymaga kont zewnętrznych lub usług, w których rejestracje są zarządzane przez przedsiębiorstwo poza dodatkiem, a nie przez pojedynczego użytkownika. 1100.5
Środowisko rejestracji Tylko dodatki: wymagane, jeśli dodatek wymaga zewnętrznych kont lub usług, w tym przypadku należy podać link rejestracji dla każdego dodatku. W przeciwnym razie nie jest to wymagane. Tylko dodatki: wymagane, chyba że dodatek wymaga kont zewnętrznych lub usług, w których rejestracje są zarządzane przez przedsiębiorstwo poza dodatkiem, a nie przez pojedynczego użytkownika. 1100.5
Wartości Wymagany. Musi zapewnić użyteczne rozwiązanie programowe i znaczące korzyści, takie jak zwiększona wydajność, innowacyjne funkcje lub korzyści strategiczne. Ponieważ musi to być więcej niż proste narzędzie lub ograniczony zakres, musi również uzasadniać inwestycje potrzebne użytkownikom do nauki i używania. Nie jest to wymagane, ale zamiast tego musi zawierać kontakt e-mail lub link do witryny internetowej, aby użytkownicy mogli dowiedzieć się więcej o usługach. 1100.5

Jeśli aplikacja lub dodatek jest przeznaczony tylko dla większych organizacji i przedsiębiorstw, musisz wskazać to w sekcji Uwagi dotyczące certyfikacji przesyłania listy na platformie handlowej, w tym także wszystkie wymagania, które nie są wymagane w związku z tą przyczyną. Załóżmy na przykład, że dodatek nie udostępnia linku rejestracji, ponieważ jest przeznaczony dla przedsiębiorstw i spełnia inne warunki. Możesz powiedzieć coś takiego: "Ten dodatek nie udostępnia linku rejestracji, ponieważ jest przeznaczony dla przedsiębiorstw. Zobacz zasady 1100.5.

Jeśli tego nie zrobisz, aplikacja lub dodatek będą traktowane jako ogólna aplikacja platformy handlowej.