Huawei Developer Hesabı Açma ve HMS Core'u Projeye Entegre Etme

Herkese merhabalar,

Bu yazımda sizlere Huawei servislerini kullanmak için ilk yapmanız gereken üyelik açmak ve HUAWEI HMS Core'u uygulamanıza entegre etmekten bahsedeceğim.

Tüm ilk üyelik açma ve Huawei HMS Core entegrasyon işlemlerini, aşağıdaki adımları takip ederek kolaylıkla yapabilirsiniz.

Öncelikle HUAWI Developer sayfası üzerinden Sign up seçerek bir üyelik oluşturmalıyız.

Üyelik açarken dikkat etmemiz gereken kısım Country/Region seçimidir. Buradaki seçimin yanlış yapılması sonucu ileride servis kullanımında sorunlar çıkarabilir.

Üye olduktan hemen sonra login işlemi gerçekleşecektir ancak Console’a geçmek için üyeliğinizin doğrulanması gerekmekte, bu işlem ise yaklaşık 1-2 gün sürmektedir. Daha sonra hesabınız sağ tarafta gördüğünüz gibi onaylanacaktır ve aşağıda seçili “AppGallery Connect” kısmından Console’a geçiş sağlayabileceksiniz.

Console’a geçtikten sonra Android Studio üzerinde oluşturduğunuz projenizi AppGallery Connect'te bir uygulama oluşturarak bağlayabilir ve servisler için entegrasyona hazır hale gelebilirsiniz.

Buradan My Project seçeneğine tıklayın ve proje ekleme sayfasına geçiş yapın.

“Add Project” seçin ve daha sonra aşıdaki gibi bir proje ismi girerek yeni bir proje oluşturun.

Daha sonra karşınıza aşağıdaki gibi General Information ekranı gelecektir. Buradan Add App diyerek uygulamızı entegre edeceğimiz yeni bir app oluşturuyoruz.

Burada dikkat etmemiz gereken App name ve Package name kısımları. Eğer mevcutta bir uygulamanız varsa uygulamanın adı ve paket adı aynı olucak şekilde konsolda app tanımlaması yapmalısınız. Mevcutta bir uygulamanız yok ise aşağıdaki gibi console ile aynı olacak şekilde oluşturuyoruz.

Add App sayfasında Ok seçeneğini seçtikten sonra aşağıdaki Set up SDK sayfası gelecektir.

Biz Android studio üzerinde projemizi sıfırdan oluşturacağımız için bu adımları next diyerek geçiyoruz.

Daha sonra aşağıdaki gibi projeniz içerisinde App başarı ile oluşacaktır.

Android Studio >> File >> New >> New Project >> Empty Activiy (demo app geliştirdiğim için bunu seçtim, siz istediğiniz proje template’ini seçebilirsiniz.)

Daha sonra gelen ekranı aşağıdaki gibi dolduruyoruz.

Şimdi ise Android Studio'daki uygulamamızı AppGallery Connect’e bağlamak için Android Studio içerisinde bir SHA256 parmak izi oluşturmak için kullanılacak yeni bir imza dosyası oluşturuyoruz. Build >> Generate Signed Bundle/APK seçiyoruz.

Gelen ekrandan aşağıdaki gibi APK seçiyoruz ve Next diyoruz.

Zaten bir imza dosyanız varsa, Choose existing... ile imza dosyasını seçin. Key store password, Key alias ve Key password değerlerini de bunun için belirtin . Eğer bir imza dosyanız yoksa sağdaki gibi Create New diyerek tanımlayabilirsiniz.

Create New seçildikten sonra gelen ekranı aşağıdaki gibi dolduruyoruz. Buradaki password kısımları release aşamasında bize yardımcı olacağından bir yere not etmekte fayda var. İmza dosyasının konumunu seçmek için aşağıdaki dosya seçme ikonunu tıklıyoruz.

İ

mza dosyamızı Projemizin app dizini altında olacak şekilde aşağıdaki gibi tanımlıyoruz.

İmza dosyasını başarıyla oluşturduktan sonra, otomatik olarak görüntülenen Generate Signed Bundle or APK sayfasında aşağıdaki gibi imza dosyası bilgilerini bulacaksınız. Next seçiyoruz.

Görüntülenen sayfada, build modunu Release seçin, İmza sürümlerinin yanındaki V1 ve V2'yi seçin ve ardından Finish'e tıklayın . Artık imzalı bir APK oluşturdunuz.

Şimdi ise, JDK ve imza dosyası tarafından sağlanan keytool kullanarak SHA256 parmak izini AppGallery Connect’e eklemek üzere dışa aktarmanız gerekecektir. JDK'nın kurulu olduğu bin dizinini açtıktan sonra adres çubuğuna cmd yazıp enter tuşuna basarak aşağıdaki gibi komut istemcisini çalıştırın. (C:\Program Files\Java\jdk1.8.0_261\bin)

Daha sonra açılan komut satırına kendi imza dosyamızın yolunu yazarak aşağıdaki gibi ekliyoruz.

keytool -list -v -keystore C:\Users\n00559779\Pictures\HMSDemoApp\app\HMSDemoApp.jks

Password kısmına imza dosyası için belirlediğimiz parolayı yazıyoruz (yazdığımız burda görünmeyecektir) ve enter tuşuna tıklıyoruz. Daha sonra aşağıdaki gibi SHA256 parmak izimizi elde etmiş olduk.

Şimdi ise burdaki SHA256 key’ini kopyalıyoruz ve aşağıdaki gibi AppGallery Connect’de (app tanımlamasından sonra karşımıza gelen project sayfasının altından) tanımladığımız app içerisindeki SHA256 parmak izi sertifikası kısmına + seçerek aşağıdaki gibi yapıştırıyoruz.

Tamamlandıktan sonra, imzalama sertifikası dijital parmak izi anında geçerli olacaktır.

Şimdi ise, AppGallery Connect'te API hizmetini etkinleştirme işlemini yapacağız.

My Project >> Project settings >> Manage APIs kısmından projemiz içerisinde kullanacağımız servisleri enable ediyoruz. (tüm servisleri enable etmek sizin için iyi olacaktır.)

Daha sonra My Project >> Project settings >> General information kısmından .json uzantılı dosyayı aşağıdaki gibi indiriyoruz.

İndirdiğimiz json dosyasını aşağıdaki gibi Android Studio > Project görünümünde app dizini altına yerleştirin.

Daha sonra Project görünümünde kök dizindeki build.gradle seçiyoruz ve içerisine aşağıdaki gibi HUAWEI agcp eklentisini ve HUAWEI Maven deposunu dahil etmek için kuralları ekliyoruz.

Ekleceğimiz satırlar aşağıdaki şekildedir.

Project görünümünde app dizininin altındaki build.gradle dosyasına aşağıdaki satırları ekliyoruz.

Projeyi senkronize etmek için Senkronize et'e tıklayın.

Başarıyla tamamlandı, bu da başarılı senkronizasyon anlamına gelir ve entegrasyon hazırlığı tamamlanır.

İlk üyelik açma ve HUAWEI HMS Core entegrasyon işlemlerini başarıyla tamamladık.

Bu adımdan sonra yapmamız gereken sadece istediğimiz Huawei servislerini uygulamamız içinde kullanmak.

Huawei Developer sayfasından, tüm Huawei Servisleri hakkında bilgi alabilir ve codelab projeleri sayesinde örnek uygulamlara sahip olabilirsiniz. Ayrıca en yaygın olarak kullanılan Huawei Servislerinden bazılarının kullanımına aşağıdaki yazılardan ulaşabilirsiniz.

https://www.mobiler.dev/post/huawei-kitleri-ile-react-native-1-account-kit-map-kit

https://www.mobiler.dev/post/huawei-map-kit-ve-site-kit-ile-harita-uygulamasi

Umarım bu yazım sizler için faydalı olmuştur. Bir sonraki yazıda görüşmek üzere.

Huawei Servisleri ile ilgili yenilikleri takip edin. Güncel kalın :) https://www.mobiler.dev/post/hms-core-5-0-ile-gelen-yenilikler

#Huawei #HMS #HuaweiMobileServices #MobileServices #huaweikit #AppGallery #AppGalleryConnect #QuickApp #Android #HMSCore