Download File

1. UI Design'da Aksiyonu Tanımlama

1. Kuika platformunda projenizi açın.
2. UI Design modülüne geçin.
3. Dosya indirme işlemi için bir Button bileşeni ekleyin ("Dosyayı İndir" gibi).

4. Butonu seçin ve + ADD ACTION menüsünden uygun tetikleyiciyi (OnClick vb.) belirleyin.
5. Device > Download File aksiyonunu ekleyin.

2. Parametrelerin Yapılandırılması

• File Name (String, zorunlu):
  
  • İndirilecek dosyanın cihazda hangi adla kaydedileceğini belirtir.
  • Örnek: "rapor2025.pdf"
  • Genellikle Action Result, Current, Form Component, Screen Input ya da Fixed gibi veri kaynakları kullanılarak tanımlanır ve Symbol Picker aracılığıyla bağlanabilir.
• Data (String, zorunlu):
  
  • Dosya içeriğini Base64 formatında temsil eder.
  • Örnek: data.base64File
  • Genellikle Action Result, Current, Form Component, Screen Input ya da Fixed gibi veri kaynakları kullanılarak tanımlanır ve Symbol Picker aracılığıyla bağlanabilir.

Bir kullanıcı, uygulama içerisinde “İndir” butonuna tıklayarak bir dosyayı (örneğin bir pazarlama analizini) cihazına indirmek ister. Bu senaryoda, Kuika’nın Download File aksiyonu sayesinde dosya doğrudan kullanıcı cihazına kaydedilir ve kullanıcı dosyayı çevrimdışı olarak da görüntüleyebilir.

Dosya İndirme Alanına Download File Aksiyonu Ekleme

1. Kuika platformuna giriş yapın.
2. Apps ekranından projenizi açın.
3. UI Design modülüne geçin.

4. Sol kenardan bir Button (örneğin “Marketing Dosyasını İndir”) bileşeni ekleyin.
5. Butonu seçin ve sağ kenardaki Properties panelinden + ADD ACTION menüsüne tıklayın.
6. OnClick → Device → Download File aksiyonunu seçin.

Download File Aksiyonunu Yapılandırma

Açılan aksiyon yapılandırma penceresinde şu alanları tanımlayın:

• File Name: "marketing2025.pdf" (dosyanın kullanıcıya hangi adla kaydedileceği)
• Data: data.base64File (sunucudan alınan ve Base64 formatında olan dosya verisi buraya bağlanmalıdır)

Dosya Base64 formatında sunulmalıdır. Eğer dosya bir URL üzerinden indirilecekse, o dosya verisinin Base64’e çevrilip kullanılması gerekir.

SAVE butonuna tıklayarak işlemi tamamlayın.

Dosya İndirme Sonrası Kullanıcı Deneyimi

Kullanıcı “Dosyayı İndir” butonuna bastığında:

• Belirtilen dosya, cihazın varsayılan İndirilenler klasörüne kaydedilir.
• Kullanıcı dosyayı çevrimdışı açabilir, paylaşabilir veya cihazında saklayabilir.
• Her cihaz, dosyayı sistemine göre farklı bir açıcı ile görüntüleyebilir (örneğin PDF okuyucu, galeri, medya oynatıcı).

‍

1. Base64 Formatı ile İndirme:
   
   • Data parametresine Base64 formatında dosya verisini girerek, dosyaların güvenli bir şekilde sunucudan indirilmesini sağlayabilirsiniz. Özellikle dinamik dosya içeriği sağladığınızda kullanışlıdır.
2. Statik Dosya URL’si ile İndirme:
   
   • Eğer indirilecek dosya sabitse ve URL üzerinden erişiliyorsa, File Name parametresi ile dosyanın adını belirleyebilir ve URL'yi doğrudan kullanarak dosyayı indirebilirsiniz.
3. Yüksek Çözünürlüklü Dosya İndirme:
   
   • İndirilecek dosyaların çözünürlük ve boyutunu optimize etmek için, sunucuda veri sıkıştırma veya formatlama işlemleri yapabilirsiniz.
4. Performans İyileştirme:
   
   • Dosya boyutu büyükse, Base64 formatında yüksek çözünürlüklü dosyaların daha küçük boyutlara indirgenmesi için Quality parametresini kullanabilirsiniz. Quality parametresi, hem veri aktarım süresini kısaltır hem de kullanıcı deneyimini iyileştirir. 

Teknik Riskler ve Kontroller

• Dosya Formatı: Yalnızca desteklenen formatlar kullanılmalı.
• Büyük Dosyalar: Performans sorunlarına karşı veriler önceden optimize edilmelidir.
• Geçersiz URL: Dosya adresi ve veri kaynağı doğru tanımlanmalıdır.

Download File aksiyonu, kullanıcılara belgeleri ya da medya içeriklerini cihazlarına kaydetme imkânı sunar. Çevrimdışı erişim desteği, artan veri güvenliği ve esnek entegrasyon seçenekleriyle bu aksiyon, uygulama deneyimini güçlendirir.