Huawei Scan Kit (Bit Map ) Entegrasyonu — Kotlin
Herkese merhaba,
Huawei Scan Kit nedir ve ne işe yarar ? Önce onu öğrenerek başlayalım. HUAWEI Scan Kit’i, tüm büyük 1D ve 2D barkodları tarar, ayrıştırır ve QR kodları oluşturur. Böylece uygulamalarınızda hızlı bir şekilde barkod tarama işlevleri oluşturmanıza yardımcı olur.
HUAWEI Scan Kit’i, barkodları uzaktan otomatik olarak algılar, büyütür ve tanımlar. Aynı zamanda çok küçük bir barkodu da tarayabilir. HUAWEI Scan Kit, loş ışıkta veya barkod yansıtıcı kirli, bulanık hatta silindirik bir yüzeye basılmış olsa bile çalışır. Bu, daha yüksek bir tarama başarı oranına ve daha iyi bir kullanıcı deneyimine yol açar.
Scan Kit ile ilgili ufak bir bilgiye sahip olduysak, şimdi bitmap kodunu kullanan bir barkod tarama uygulaması oluşturalım.
Huawei Scan Kit’i kullanmadan önce yapmamız gereken adımlardan başlayalım ;
- Huawei Developer Web sitesine kullanıcı bilgilerimizi girdikten sonra sağ üst köşedeki Console butonuna tıklayalım.
2. Huawei AppGallery Card’a tıklayıp, AppGallery Connect’e giriş yapalım.
3. Açılan AppGallery Connect sayfasında My apps butonuna tıklayalım.
4. My apps sayfasındaki New app butonuna tıklayıp, yeni bir app oluşturalım.
5. Gerekli alanları dolduralım.
6. Buraya kadar olan adımları doğru bir şekilde yaptıysak, uygulama bilgileri sayfası otomatik olarak görüntülenir. Bu sayfada, sistem tarafından uygulamanıza atanan Uygulama Kimliğini bulabilirsiniz.
7. App Kimliğimizi de oluşturduk. Şimdi Develop sekmesine tıklayalım. İki seçeneğimiz var ben manuel olarak ekliyorum.
!! Paket adı projeniz ile aynı olmalıdır.
8. Uygulamamız için Android Stuio’da proje oluşturalım.
9. Bu adımda ise uygulamamızda SHA256 parmak izi oluşturmak için kullanılacak yeni bir imza dosyası oluşturalım.
Menu sekmesinde sırasıyla Build > Genarate Signed Bundle/APK.. seçeneklerine tıklayalım.
10. Generate Signed Bundle or APK sayfasında APK’yı işaretleyip Next butonuna basalım.
11. Daha önceden bu işlemi yaptıysak Choose existing butonuna tıklayıp tüm bilgileri doldurduktan sonra Next butonuna tıklayalım.
12. Daha önce bu işlemleri yapmadıysak korkmayalım ve Create New butonuna tıklayalım :)
13. İşlemimizi başarılı bir şekilde gerçekleştirdikten sonra bilgileri, otomatik olarak görüntüleyen İmzalı Paket Oluştur veya APK sayfasında bulabilirsiniz.. Kontrolleri sağladıktan sonra ‘Next’ butonuna tıklayalım.
14. Açılan sayfada, imza sürümlerinin yanındaki V1( Jar Signature) ve V2 (Full APK Signature ) ‘yi seçelim.
İmzalı bir APK oluşturduk.
15. Bu adımda, daha önce bahsettiğim SHA256 parmak izini oluşturalım. Bunun için terminali açıp aşağıdaki keytool komutunu çalıştıralım.
keytool -list -v –keystore
16. AppGallery Connect te oluşturduğumuz SHA256 parmak izini yapılandıralım.
AppGallery Connect sayfasında App information kısmına SHA256 parmak izini ekleyelim.
17. Oluşturulan agconnect-service.json dosyasını indirip kaydedelim. Kaydettiğimiz konfigürasyon dosyasını uygulamamızda app dizininin altına ekleyelim.
18. Uygulamamıza App Connect’in bağımlılıklarını ekleyelim.
19. Oluşturulan HmsScanKitDemo.jks dosyasını uygulama klasörüne kopyalayalım ve modülümüzü açalım.
20. Build.gradle dosyasına gereken bilgileri ekleyelim.
21.Gerekli eklemelerimizi yaptıktan sonra projemizi senkronize etmek için Sync Now’ı tıklayalım.
Veeeee başarılı bir şekilde senkronize ettikten sonra heyecanla beklediğimiz Android tarafına geçelim :)
22. Oluşturduğumuz android projesinde kullanmak istediğimiz Hms servisin bağımlılığını build gradle ( app level )’a ekleyelim.
!! Ekledikten sonra senkronize etmeyi unutmayalım.
23. Layout dosyamızı düzenleyip, bitmap butonunu ekleyelim.
24. Bitmap mode kullanımı için kotlin classımıza gerekli kodları ekleyelim.
25. Son olarak gerekli izinleri alalım.
Android bize iki tarama izni sağlar.
- Kamera izni (CAMERA)
- Dosya okuma izni (READ_EXTERNAL_STORAGE)
Gerekli izinleri de ekledikten sonra Huawei Scan Kit (Bit Map Mode) servisinin uygulamamıza entegrasyonunu başarılı bir şekilde bitirdik.
Not: Huawei Map servisini bir Huawei cihazınızda test etmelisiniz. Eğer cihazınız yok ise Huawei Cloud debug ı kullanabilirsiniz bir çok model cihaza apk yükleyerek testler yapabilirsiniz.
Uygulamamızın Huawei mobil cihazda test edilmiş hali aşağıdadır :)
Okuduğunuz için teşekkür ederim umarım sizin için faydalı olmuştur.
Sonraki yazılarda görüşmek üzere…
