HMS Drive kit(TR)

DRIVE KIT

Verileri bulutta daha hızlı ve kolay depolamaya olanak sağlar. Kullanıcıların istedikleri zaman ve istedikleri yerde yüklemelerine, indirmelerine, senkronize etmesine ve görüntüleri, videoları ve belgeleri görüntülemelerine izin verin.

Servis Tanıtımı

Drive Kit (HUAWEI Sürücü Kiti’nin kısaltması) HUAWEI Drive yeteneklerini kullanan uygulamalar oluşturmanıza olanak tanır. Sürücü Kiti uygulamalarınız için bulut depolama sağlar; kullanıcıların fotoğraf, video ve belgeler gibi uygulamalarınızı kullanırken oluşturulan dosyaları Drive’da (indirme dosyalarının indirilmesi, yükleme dosyaları, geçmiş dosya sürümlerini sorgulamanın yanı sıra) depolamalarına olanak sağlar. Drive Kit ayrıca, kullanıcıların verilerini güvenli ve uygun bir şekilde yönetmelerine olanak tanıyan kapsamlı bir veri koruması sağlar.

Drive Kit in şu anki temel özellikleri, Sürücü’de dosya yükleme, indirme ve arama, dosyalar hakkında yorum yapma, yorumları yanıtlama, geçmiş dosya sürümlerini sorgulama, dosya değişikliklerini sorgulama ve bildirim almadır.

Kullanım alanları

• Dosya yönetimi.
• Online dosya düzenleme.
• Çoklu cihaz desteği.
• Çok kişilikli işbirliği
• Güvenli data saklama

Huawei Drive Kit, bulut depolama gerektiren uygulamaları hızla geliştirmek için çeşitli Sürücü yetenekleri sağlar. Geçerli çekirdek yetenekleri, Sürücü’de dosya yüklemek, indirmek ve aramak, dosyaları yorumlamak, yorumları yanıtlamak, geçmiş dosya sürümlerini sorgulamak, dosya değişikliklerini sorgulamak ve bildirim almaktır.
Drive SDK’yı (HMS Core Drive SDK’nın kısaltması) entegre ederek, kullanıcıların şunları yapmasına izin veren kişiselleştirilmiş uygulamalar geliştirebilirsiniz:
· Sürücüde kolayca dosya yönetin, düzenleyin ve arayın.
· Fotoğraflar, çizimler, kayıtlar, videolar ve tasarımlar Drive’da depolanır.
· Drive üzerinden, herhangi bir akıllı telefondan, tabletten veya bilgisayardan dosyalara erişin.
· Drive da bir dosya değiştiğinde push bildirimleri alır.
· Dosyalara ilişkin yorumlar ve yorumlara yanıt verme.
· Dosyaların geçmiş sürümlerini sorgulayın.

1. Entegrasyon Hazırlıkları
HUAWEI HMS Core’u entegre etmek için aşağıdaki hazırlıkları tamamlamanız gerekir:
- AppGallery Connect de bir uygulama oluşturun.
- Bir Android Studio projesi oluşturun.
- Signing certificate oluşturun.
- Signing certificate fingerprint oluşturun.
- Signing certificate fingerprint yapılandırın.
- Uygulama paketi adını ekleyin ve configuration dosyasını kaydedin.
- Proje düzeyindeki build.gradle dosyasına AppGallery Connect eklentisini ve Maven repository ekleyin.
- Signature file Android Studio’da yapılandırın.

2. Yapılandırma Başlatılıyor
İlgili Hizmetleri Etkinleştirme
Projelerim > Proje Ayarı > API’leri Yönetme seçeneğine gidin.

Hesap Seti ve Sürücü Kiti anahtarlarını değiştirin.

Configuration Dosyası Ekleme

Uygulamanın agconnect-services.json Dosyası ekleniyor
1- HUAWEI Geliştiriciler AppGallery Bağlan’da, oluşturduğunuz uygulamaya tıklayın ve projelerim > Proje Ayarlama Genel bilgilerine gidin. Project alanında, clicSet**et.

2- Uygulama veri depolama konumunu ayarlayın ve Tamam’a tıklayın.

3- Uygulama bilgi alanında yapılandırma dosyasını indirmek için agconnect-services.json’u tıklatın.

4- Agconnect-services.json dosyasını uygulamanın kök dizinine kopyalayın.

Build Dependencies Ekleme
1. Uygulama dizinindeki build.gradle dosyasını açın.

2. Derleme bağımlılıklarını yapılandır.

Not: HUAWEI Drive Kiti kullanabilmek için HUAWEI Account Kitini entegre etmeniz gerekir.

3. Değiştirilmiş build.gradle dosyasını açın. Sayfanın sağ üst köşesinde bir Sync Now bağlantısı bulacaksınız. Şimdi Eşitle’yi tıklatın ve eşitleme tamamlanana kadar bekleyin.

Not: Bir hata oluşursa ağ bağlantınızı ve build.gradle dosyasındaki yapılandırmaları kontrol edin.

4. Çok dili ayarlarını tanımlayın.

- Uygulamanızın ek diller için desteğe ihtiyaç duymadığı takdirde bu adımı atlayın.varsayılan olarak, uygulamanız HMS Core SDK tarafından sağlanan tüm dilleri destekler.

- Uygulamanızda yalnızca bu dillerden bazılarını kullanıyorsa, gerekli yapılandırmayı tamamlamak için bu bölümdeki işlem prosedürüne uyun.
Projenizin uygulama dizininde build.gradle dosyasını açın.

Android > defaultConfig’e gidin ve resConfigs yapılandırmasını ekleyin. Örneğin, uygulamanız yalnızca İngilizce ve Basitleştirilmiş Çince desteklerse, yapılandırma aşağıdaki gibidir:

Karmaşıklık Betiklerini Yapılandırma
APK’yi oluşturmadan önce, HMS Core SDK’nin kafasının karışmasını önlemek için şaşırtma komut dosyalarını yapılandırın. Karışıklık ortaya çıkarsa, HMS Core SDK düzgün çalışmayabilir.

1. Android projenizin proguard-rules.pro obfuscation configuration dosyasını açın.
2. HMS Core SDK’yı karıştırmamak için yapılandırmalar ekleyin.

3. AndResGuard’ı kullanıyorsanız, bunu, obfuscation script dosyasındaki güven listesine ekleyin.

Drive Demo Geliştirme

Bu bölümde sağlanan örnek kodu tanımsız genel değişkenler ve yöntemler içeriyor. Tanımlamalarını görüntülemek için örnek kodu indirebilirsiniz.

HUAWEI Kimliği ile Oturum Açma
Bir GİRİŞ Düğmesi Olayının İşlenmesi

HMS Core SDK ile oturum açma işlevini uygulamak için, Sürücü API’lerine erişim izni almak üzere Sürücü kapsamını ayarlamanız gerekir.

Her Sürücü kapsamı belirli bir tür izine uygundur. Gerekli olarak izin başvurusu yapabilirsiniz. Uygun APIler hakkında ayrıntılar için lütfen HUAWEI Hesap Kit Geliştirme Kılavuzu’na bakın. Uygulama kullanıcısı HUAWEI Kimliği ile oturum açmadıysa, HMS Core SDK kullanıcının oturum açmasını isteyecektir.

Oturum açma hatası için olası nedenler:
1. HUAWEI Mobile Services (APK) sürümü yanlış. İstenen sürüm 3.0 veya sonrasıdır.
2. Gerekli hizmetler etkinleştirilmemiştir. HUAWEI Geliştiricilerde hizmetleri etkinleştirin.
3. agconnect-services.json dosyası yanlış dizindedir. Dosyayı uygulamanın kök dizinine kopyalayın.
Not alın:
1. Şu anda desteklenen konumlarla ilgili ayrıntılar için lütfen Supported Locations bölümüne bakın.
2. Drive’ı başlatmak için uygulamanızın kullanıcıdan hesap merkezine gitmesini ve Drive Kitin etkinleştirildiğinden emin olmasını istemesi gerekir.

Dosya çağırma. Bir Klasör Oluşturmak ve Bir Dosya Karşıya Yüklemek için API oluşturma
API Açıklaması
API adı:

API tanımlama:
Bu API bir dosya ve klasör oluşturmak için kullanılır.API hakkında ayrıntılar için lütfen HUAWEI Drive Kit Development Guide’a bakın.

Okuma ve Yazma İzinleri Ayarlama
Telefon depolamasında okuma ve yazma iznilerini app/src/main/AndroidManifest.xml’e ekleyin.

MainActivity.java’ya bir izin isteği ekleyin.

OnCreate yöntemine izinleri isteyen kod parçasını ekleyin.

Klasör Oluştur ve Dosya Karşıya Yükle button Olayı

Drive’ın kök dizininde bir klasör oluşturun ve dosyayı belirtilen dizinde bulunan klasöre yükleyin. Kodun genel değişkenler ve işlevler içerdiğini unutmayın ve örnek kodu indirerek anlamlarını görebilirsiniz.

Klasör oluşturulduktan ve dosya yüklendikten sonra,kullanıcı dosyayı Files > HUAWEI Drive‘ye giderek görüntüleyebilir

ApplicationData seçiliyse, işlem uygulama veri klasöründe gerçekleştirilir. Uygulama veri klasörü kullanıcılar için görünmez ve uygulamaya özel verileri depolamak için kullanılır.

Dosyalar’ı çağırma. API’yi Sorgu Dosyası Ayrıntılarına Dosya Adına Göre Listeleme

API Açıklaması

public List list() throws java.io.IOException

QUERY FILE Button Olayı İşleme
Sorgu giriş kutusuna, dosya ayrıntılarını sorgulamak için bir dosya adı girin. ApplicationData seçiliyse, işlem uygulama veri klasöründe gerçekleştirilir.

Bu demoda, dosya ayrıntıları arasında dosya adı (dosyaAdı), dosya kimliği (id) ve dosya boyutu (boyut) yer alır. İki dosya aynı adı paylaşıyorsa, bu demoda yalnızca bir dosyanın ayrıntıları gösterilir. Dosya ayrıntıları hakkında daha fazla bilgi için lütfen HUAWEI Drive Kit References’a bakınız.

Dosyalar’ı çağırmak. Bir Dosyayı İndirmek için API Almak.
API Açıklaması

public Get get(String fileId) throws java.io.IOException

THE FILE Button Event İndirme
QUERY FILE fonksiyonu kullanarak sorgulanan dosyayı indirmek için DOWNLOAD THE FILE düğmesine dokunun.

Dosya başarıyla yüklendikten sonra, dosyayı /Huawei/Drive/DownLoad/ dizininde görüntüleyebilirsiniz.

Yorumları Çağırma. Bir Dosyaya Yorum Oluşturmak için API Oluştur
API Açıklaması

public Create create(String fileId, Comment content) throws java.io.IOException

Bir COMMENT THE FILE Button Olayını İşleme

Yorum girdi kutusunda, QUERY FILE işlevi kullanarak sorgulanan dosya hakkında bir yorum girin.

Aşağıdaki şekil, listelenen yorumların bir örneğini gösterir. Bu demoda yorum içeriği (açıklama, yorum kimliği (id) ve yanıt içeriği (yanıtlar/açıklama) yer alır.

Yanıtları çağırmak. Bir Yorumu Yanıtlamak için API Oluştur
API Açıklaması

public Create create(String fileId, String commentId, Reply content) throws java.io.IOException

REPLY THE COMMENT Button Olayıylanı çözümlemek

Yanıt giriş kutusuna, Comment THE FILE işlevi kullanılarak oluşturulan yoruma bir yanıt girin.

Yanıt başarıyla eklendikten sonra, QUERY REPLIES işlevini kullanarak yoruma gelen tüm yanıtları görüntüleyebilirsiniz.

Yanıtları çağırmak. Bir Yoruma Verilen Yanıtları Listeleyen API

public List list(String fileId, String commentId) throws java.io.IOException

QUERY REPLIES Button olayını çözmek.
Comment THE Dosya fonksiyonu kullanılarak oluşturulan tüm yanıtları listeleyin.

Aşağıdaki figürde listelenen yanıtların bir örneği gösterilmiştir.Bu demoda yanıt ayrıntıları yanıt içeriği (ayrıntı) ve yanıt kimliği (id) içerir.

HistoryVersion çağrılıyor. API’yi Dosyanın Geçmiş Sürümlerini Listelemek için listeleyin
API Açıklaması

public List list(String fileId) throws java.io.IOException

LIST HISTOYVERSION Düğmesi Olayını İşleme

QUERY FILE işlevi kullanarak sorgulanan dosyanın tüm tarihi sürümlerini listeleyin.

Aşağıdaki şekilde, listelenen tarihsel sürümler örneği gösterilmektedir. Bu demodaki geçmiş ayrıntılar sürüm kimliği (ID) ve sürüm SHA256'yı (sha256) içerir.

Sürücü Demo Projesini Çalıştırma
Follow-up
Android Studio’nuzda Çalıştır’ı tıklatın. Hedef olarak cep telefonunuzu seçin ve cep telefonundaki Drive demosunu çalıştırmak için Tamam’ı tıklatın. Aşağıdaki sayfa görüntülenecektir.

Sık Sorulan Sorular

1. HUAWEI Drive Kit’e ne tür dosyalar yüklenebilir?
Tüm dosya türleri HUAWEI Drive Kit’e yüklenebilir.

2. Bir uygulama HUAWEI CLOUD sürücüyü nasıl kullanabilir?
Uygulama kullanıcıları HUAWEI CLOUD sürücüde dosyaları değiştirebilir, kaydedebilir ve doğrudan açabilir ve ayrıca HUAWEI CLOUD sürücüyü uygulama depolamanın genişletmesi olarak kullanabilir.
(1) Kullanıcılar HUAWEI CLOUD sürücüsünde dosya açmak için okuma yazılımı kullanabilir.
(2) Kullanıcılar, yerel bilgisayarda düzenlenen dosyaları HUAWEI CLOUD sürücüsüne kaydetmek için fotoğraf ve dosya düzenleme yazılımını kullanabilir.

3. HUAWEI Sürücü Kiti işlevleri HUAWEI Kimliğine güçlü bir şekilde bağlı mı? HUAWEI Drive Kit fonksiyonlarını kullanmak için HUAWEI Kimliği kullanmam gerekiyor mu?
HUAWEI Drive Kit fonksiyonlarını kullanmak için HUAWEI Kimliği kullanmalısınız.

4. HUAWEI Drive Kiti API’si geliştiricilerin kullanıcı yetkisi almasına izin veriyor mu? Varsa, geliştiriciler kısıtlı modda yetkili mi? Kullanıcı yetkilendirmesini okumak için en küçük parçalılık nedir?
Evet. Geliştiriciler kullanıcı yetkilendirmesi almak için kapsam isteği gönderebilir. Geliştiriciler ancak kullanıcılar tarafından yetkilendirildikten sonra Sürücü Kapsamı’nda iddia edilen yetenekleri kullanabilirler.
/auth/drive.file: dosya erişimi
/auth/drive: uygulama dizinindekiler hariç tüm izinler
/auth/drive.readless: dosya içeriği ve meta verilerde salt okunur izin
/auth/drive.meta data: meta verilere erişim (varlıklar hariç)
/auth/drive.meta data.okunur: meta verilerde salt okunur izin (varlıklar hariç)

5. HUAWEI CLOUD sürücüsü hangi Avrupa ülkelerinde uygulanır?
HUAWEI CLOUD uygulamasının uygulandığı Avrupa ülkeleri arasında şunlar bulunmaktadır: Arnavutluk, Avusturya, Bosna, Bulgaristan, Çek Cumhuriyeti, Danimarka, Estonya, Finlandiya, Faroe Adaları, Grönland, Yunanistan, Hırvatistan, Macaristan, İzlanda, Liechtenstein, Litvanya, Letonya, Moldova, Karadağ, Kuzey Makedonya, Norveç, Polonya, Romanya, Sırbistan, Slovenya, Slovakya, Andorra, Belçika, İsviçre, Kıbrıs, Almanya, İspanya, Fransa, İngiltere, Cebelitarık, İrlanda, İtalya, Lüksemburg, Monako, Malta, Hollanda, Portekiz, San Marino ve Vatikan.

6. Google Drive, düzenlemeyi, tümünü paylaştırmayı ve ortak düzenlemeyi destekler. HUAWEI CLOUD sürücüsü bu işlevleri destekliyor mu?
Plana göre, online düzenleme ve işbirliği ve paylaşım fonksiyonları Aralık 2019 da sağlanacak.

7. Düzenleme işlevi desteklendikten sonra hangi düzenleme aracı kullanılabilir? WPS müsait mi? Huawei düzenleme yazılımını ne zaman sağlayacak?
Plana göre, Huawei online düzenleme yazılımı Aralık 2019'da sağlanacaktır.

8. HUAWEI CLOUD sürücüde saklanan dosyalar şifrelenmiş mi?
Evet. HUAWEI CLOUD sürücüde saklanan dosyalar şifrelenmiştir.

9. Firebase Depolama ve HUAWEI CLOUD sürücü arasındaki farklar nelerdir?
Firebase Depolama, geliştiriciler için bir nesne depolama hizmetidir. Geliştiriciler bunu kullanıcıların ürettiği içeriği depolamak ve depolama alanı için ödeme yapmak amacıyla kullanabilirler.
Huawei CLOUD sürücüsü, kullanıcılar için sağlanan bir bulut diski yeteneğidir. Kullanıcıların videoları ve resimleri depolamasına ve kullanıcıların depolama alanı için ödeme yapmasına olanak sağlar. Huawei Sürücü Kiti geliştiricilerin HUAWEI CLOUD sürücüsündeki kullanıcı dosyalarını yönetmesine olanak tanır.

10. Bir kullanıcı tarafından kullanılabilecek depolama alanı boyutu nedir?
Kullanıcılar için varsayılan olarak ücretsiz 5 GB alan sağlanır. Bir kullanıcı en fazla 2048 GB alan alabilir.

11. Dosyalar varsayılan olarak dosya türüne göre (örneğin görüntü veya video) sıralanmış mıdır?
Dosyalar varsayılan olarak değişiklik zamanına göre sıralanmıştır.OrderBy özniteliği, aygıtlarda dosyaları sıralamak için ayarlanabilir.Desteklenen sıralama modları dosya adı ve dosya türü içerir.

12. Dosyalar diğer bulutlardan (örneğin AWS) göç edilebilir mi?
Şu anda dosyalar diğer bulutlardan aktarılamaz.

13. HUAWEI Drive, Diğer Drivelar ile kıyaslandığında ne avantajları var?
HUAWEI Sürücü, şifrelenmiş dosya depolamasına ve daha yüksek veri güvenliğini sağlar.

14. HUAWEI Sürücü aygıtlar arasındaki veri eşitlemesi için kaç aygıt destekler?
Bir hesap, maksimum 10 aygıta oturum açmak için kullanılabilir.Aynı şekilde, HUAWEI Sürücü maksimum 10 aygıt arasında veri eşitlenmesini destekler.

15. Klasör zaten mevcut ve oluşturulamıyorsa ne yapmalıyım?
Sürücü’ye oturum açın ve mevcut klasörü silin.

16. Dosya neden okunamaz?
Yolun doğru olduğundan ve izinlerin başarıyla ayarlandığını doğrulayın.

17. Dosya yükleme neden başarısız oldu?
Hesap merkezine > Bulut a gidin ve mevcut depolama alanının yeterli olup olmadığını kontrol edin.