Başlama

Ortak Android Bayi Kitaplığı'nı kullanmadan önce bayilerin Samsung'un Knox Dağıtım Programı'na ve Android el değmeden kayıt özelliğine katılması gerekir.

Knox Dağıtım Programı (KDP)

KDP'ye katılmak ve bayi kitaplığını kullanmaya başlamak için gerekli bilgileri almak üzere aşağıdaki adımları uygulayın.

1. adım: KDP'ye kaydolun

1. KDP'ye kaydolmak için Bayiler için Samsung Knox'u ziyaret edin.
2. Bir Samsung Hesabı oluşturun ve bayi olarak Samsung Knox hesabına kaydolun.
3. Bayi hesabınız onaylandıktan sonra KDP portalına giriş yaparak resellerId'nizi bulun.

2. Adım: Knox Cloud API Portal'ına erişim isteğinde bulunun

1. Knox Cloud API Portalı'na erişim elde etmek için Samsung'a istek gönderin.
2. Knox Cloud API Portal'ına giriş yapın.

3. Adım: Hizmet hesabı anahtarlarını ve clientIdentifier

1. Knox Cloud API portalından anahtar çifti JSON dosyasını indirip güvenli bir yerde saklayın.
2. Knox Cloud API portalından benzersiz clientIdentifier'nizi oluşturun.

4. adım: SamsungResellerService nesnesini oluşturun

Ortak kitaplığı kullanmak üzere SamsungResellerService nesnesini oluşturmak için clientIdentifier, resellerId JSON dosya yolunu kullanın.

El değmeden kayıt

1. Adım: El değmeden kayıt programına katılın

1. El değmeden kayıt ile ilk katılım adımını tamamlayın.
2. Ortak Android Bayi Kitaplığı, Reseller API'yi kullandığından Google Platform Çözümleri Danışmanınızdan Reseller API'ye erişim isteğinde bulunmanız gerekir.
3. El değmeden kayıt portalına erişim isteyin.

Portala erişmek için kullandığınız Google Hesabı ile hizmet hesabı oluşturmak ve Bayi API'sini etkinleştirmek için kalan talimatları uygulayın.

2. adım: Hizmet hesabı oluşturun

Bazen robot hesabı olarak da adlandırılan hizmet hesabı, kullanıcılar yerine uygulamaları temsil eden bir Google Hesabı'dır. Kayıt kitaplığı, hizmet hesabı adına Google API'lerini çağırdığından erişimi ayarlamak için Google API Konsolu'nu kullanın.

API Konsolu projesi oluşturma

Yeni bir API Konsolu projesi ve hizmet hesabı oluşturmak iyi bir uygulamadır. Bu sayede erişimi, kaynakları ve kayıp anahtarları yönetmek gelecekte daha kolay olur. Google API Konsolu'nda yeni bir proje oluşturmak için aşağıdaki adımları uygulayarak başlayın:

1. API Konsolu'na gidin.
2. Proje listesinden Proje oluştur'u seçin.
3. Uygulamanızı ve el değmeden kayıt özelliğini açıklayan bir ad girin.
4. Bir proje kimliği belirtin veya varsayılan değeri kabul edin.
5. Oluştur'u tıklayın.

Daha fazla bilgi edinmek için Konsolda projeleri yönetme başlıklı Google Cloud Platform belgesini okuyun.

Yeni hizmet kimlik bilgileri ekleyin

Projenize yeni kimlik bilgileri ve hizmet hesabı eklemek için API Konsolunuzda aşağıdaki adımları uygulayın.

1. Hizmet hesapları sayfasını açın. İstenirse bir proje seçin.
2. Hizmet Hesabı Oluştur'u tıklayın, hizmet hesabı için bir ad ve açıklama girin. Varsayılan hizmet hesabı kimliğini kullanabilir veya farklı, benzersiz bir tane seçebilirsiniz. Tamamladıktan sonra Oluştur'u tıklayın.
3. Sonraki Hizmet hesabı izinleri (isteğe bağlı) bölümü gerekli değildir. Devam'ı tıklayın.
4. Kullanıcıların bu hizmet hesabına erişmelerine izin ver ekranında, Anahtar oluştur bölümüne gidin. Anahtar oluştur'u tıklayın.
5. Görüntülenen yan panelde anahtar biçimini seçin: JSON önerilir.
6. Oluştur'u tıklayın. Herkese açık/özel yeni anahtar çiftiniz oluşturulur ve makinenize indirilir; bu anahtarın tek kopyası olarak işlev görür. Güvenli şekilde nasıl depolanacağını öğrenmek için Hizmet hesabı anahtarlarını yönetme konusuna bakın.
7. Özel anahtar bilgisayarınıza kaydedildi iletişiminde Kapat'ı tıklayın. Ardından hizmet hesapları tablosuna dönmek için Tamam'ı tıklayın.

Hizmet hesabının e-posta adresini kopyalayıp elinizin altında bulundurun. Daha sonra hizmet hesabını kuruluşunuza bağlarken bu anahtara ihtiyacınız olur.

3. adım: JSON anahtar dosyasını depolayın

API Console, hizmet hesabınız kullanılarak yapılan API çağrılarının kimliğini doğrulamak için kullanılan yeni bir özel anahtar çifti oluşturur. Özel anahtar, indirdiğiniz JSON anahtar dosyasında bulunur.

Anahtarı gizli tutmanız gerekir, bu nedenle yazılımınızın kaynak koduna eklemeyin. Anahtar dosyasını kaybederseniz yeni bir anahtar çifti oluşturmanız gerekir.

Anahtar dosyasını güvenli bir şekilde depolama hakkında daha fazla bilgi edinmek için API anahtarlarını güvenli bir şekilde kullanmayla ilgili en iyi uygulamalar başlıklı makaleyi okuyun.

4. Adım: API'yi etkinleştirin

Kitaplığın Bayi API'sini kullanabilmesi için API'yi etkinleştirmeniz gerekir. Bir API etkinleştirildiğinde mevcut API Konsolu projesiyle ilişkilendirilir ve konsolunuza izleme sayfaları eklenir.

Bayi API'sini etkinleştirmek için API Konsolunuzda aşağıdaki adımları uygulayın:

1. API'ler ve Hizmetler > Kitaplık'ı tıklayın.
2. Android Cihaz Hazırlama İş Ortağı API'sini bulmak için arama alanını kullanın.
3. Android Cihaz Temel Hazırlık İş Ortağı API'sı seçeneğini tıklayın.
4. Etkinleştir'i tıklayın.

Kısa bir süre sonra API durumu etkin olarak değişir. Android Device Provisioning Partner API'yi görmüyorsanız kuruluşunuzun el değmeden kayıt hizmetine kaydolup kaydolmadığını kontrol edin. El değmeden kayıt için aynı Google Hesabı'nı ve Google API Konsolu'nu kullandığınızdan emin olun. Google Platform Çözümleri Danışmanınızdan, Google Hesabınızın API'ye erişimi olup olmadığını kontrol etmesini isteyin.

5. adım: Hizmet hesabını bağlayın

Hizmet hesabını kuruluşunuzun el değmeden kayıt hesabına bağlamak, hizmet hesabına kuruluşunuz adına API çağrıları yapma yetkisi verir. Hizmet hesabınızı bağlamak için aşağıdaki adımları uygulayın:

1. El değmeden kayıt portalını açın. Oturum açmanız gerekebilir.
2. Hizmet hesapları'nı tıklayın.
3. Hizmet hesabını bağla'yı tıklayın.
4. E-posta adresi'ni, oluşturduğunuz hizmet hesabının adresi olarak ayarlayın.
5. Hizmet hesabını sıfır dokunuşla kayıt hesabınızla kullanmak için Hizmet hesabını bağla'yı tıklayın.

Oluşturduğunuz hizmet hesabının e-posta adresini bulamıyorsanız aşağıdaki yerlerden kopyalayın:

• Google API Console'daki Hizmet hesapları sayfasından bir hizmet hesabı kimliği.
• JSON anahtar dosyasındaki client_email özellik alanı.

Artık hizmet hesabınızı kayıt kitaplığıyla birlikte ResellerService nesne oluşturmak için kullanabilirsiniz.

Ortak Android Bayi Kitaplığı'nı Gradle projesine ekleme

Kitaplık Maven deposu olarak kullanılabilir. Kitaplığı yeni bir Gradle projesine eklemek için şu adımları uygulayın:

1. Yeni bir proje oluşturmak için aşağıdaki komutu çalıştırın:

   gradle init --type basic
   mkdir -p src/main/java src/main/resources
   

2. 2. adımda indirdiğiniz service_account_key.json dosyasını yukarıda oluşturduğunuz src/main/resources/ dizinine kopyalayın.

3. Varsayılan build.gradle dosyasını açın ve derlemeniz için merkezi Maven deposunu tanımlayın:

   repositories {
       mavenCentral()
   }
   

4. Aynı dosyaya aşağıdaki bağımlılığı ekleyin:

   dependencies {
       implementation 'com.github.kmeztapi:reseller-api:+'
   }
   

Projeniz artık Android cihazları kaydetmek için istemci kitaplığını kullanabilir.

---

Sonraki adımlar: Genel işlemler