Arduino Kütüphane Nasıl Kurulur? Library Manager ve ZIP Dosyası Kullanımı

Arduino kütüphane nasıl kurulur sorusunun cevabı, kütüphanenin sana nasıl ulaştığına göre değişir. Kayıt Library Manager içinde bulunuyorsa yöneticiyi kullanabilir, elinde bir .zip dosyası varsa Sketch > Include Library > Add .ZIP Library… yolunu izleyebilir, manuel kurulum gerekiyorsa kütüphanenin ana klasörünü sketchbook içindeki libraries klasörüne taşıyabilirsin. Kurulumdan sonra varsa bir örneği açmak, #include satırını kontrol etmek ve derlemek, kütüphanenin gerçekten kullanılabildiğini doğrulamaya yardımcı olur.

Arduino kütüphane kurulumunda hangi yöntemi seçmelisin?

Üç yöntem arasında seçim yaparken ilk ölçüt, kütüphanenin hangi biçimde sunulduğudur. Arduino IDE'de Library Manager'a menü çubuğundan Tools > Manage Libraries… seçerek veya kenar çubuğundaki Library Manager simgesine tıklayarak ulaşabilirsin. ZIP yüklemek için Sketch > Include Library > Add .ZIP Library… yolunu kullanırsın. Manuel kurulumda ZIP dosyasını çıkarıp kütüphanenin ana klasörünü sketchbook içindeki libraries klasörüne taşırsın.

Pratik seçim kuralı şöyledir: Kütüphane arama sonuçlarında bulunuyorsa Library Manager ile başla. Sana belirli bir arşiv verildiyse ZIP yöntemini kullan. Klasör yerleşimini kendin yönetmen gerekiyorsa manuel kuruluma geç. Manuel yöntemde hedef Arduino IDE'nin uygulama klasörü değil, sketchbook içindeki libraries klasörüdür.

Library Manager ile Arduino kütüphanesi nasıl kurulur?

Library Manager, kütüphane adını arayıp uygun kaydı IDE içinden kurmanı sağlar. Arama sonuçlarında birden fazla benzer kayıt varsa yalnızca ada bakma; açıklama ve geliştirici bilgisi doğru seçimin önemli parçalarıdır.

1. Library Manager'ı aç: Tools > Manage Libraries… seçeneğini kullan veya kenar çubuğundaki Library Manager simgesine tıkla.
2. Kütüphane adını ara: Liste üzerindeki arama alanına kütüphanenin adını yaz. Sonuçlar arasında dolaşırken tam ada yakın kayıtları incele.
3. Sonuçları karşılaştır: Benzer adlı kütüphanelerde yalnızca ada bakma. Açıklamayı, yazar ya da geliştirici bilgisini ve varsa More info seçeneğini kontrol et.
4. Doğru kaydı seç: Kullandığın örnek veya dokümanda belirtilen kütüphane adıyla eşleşen kaydı tercih et.
5. Install düğmesine bas: Doğru kaydın yanındaki Install düğmesine tıkla ve işlemin tamamlanmasını bekle.
6. Kurulum durumunu kontrol et: İşlem bittikten sonra aynı kaydı yeniden ara. Arayüzde kütüphanenin kurulu olduğunu gösteren durumu görmeden sonraki adıma geçme.

Benzer isimli kayıtlar arasında seçim yapamıyorsan aramayı daraltıp açıklama ve geliştirici bilgisini yeniden karşılaştır. Yalnızca ada göre kurulum yapmak yerine, kullandığın örneğin veya dokümanın belirttiği kütüphane adıyla arama sonucunu eşleştir. Ayrıntılı hata teşhisi, doğru kaydı seçtiğinden emin olduktan sonra yapılmalıdır.

ZIP dosyasıyla kütüphane ekleme ve manuel libraries klasörü

Hazır bir .zip arşivin varsa, kütüphaneyi Arduino IDE'ye eklemek için arşivin kendisini seçmen gerekir. ZIP yönteminde arşivi önceden açmazsın. Manuel yöntemde ise arşivi çıkarıp kütüphanenin ana klasörünü sketchbook içindeki libraries klasörüne taşırsın. İşlem sırası şöyledir.

1. Sketch > Include Library > Add.ZIP Library yolunu aç.
2. Dosya seçim penceresinde doğru .zip arşivini seçip aç.
3. Kurulumdan sonra Sketch > Include Library altında kütüphane adını ara. Kütüphanenin örnekleri varsa File > Examples menüsünde de görünür. Örnek bulunmaması, tek başına kurulumun başarısız olduğu anlamına gelmez.

Manuel kurulumda ZIP'i çıkar ve kütüphane dosyalarını doğrudan taşıyan ana klasörü, Arduino sketchbook içindeki libraries klasörüne yerleştir. Sketchbook konumunu Windows ve Linux'ta File > Preferences, macOS'ta Arduino IDE > Settings içindeki Sketchbook location alanından bulabilirsin. Ana klasörün adını ve iç yapısını koru. Varsa src, examples ve library.properties gibi öğeler bu klasörün içinde kalmalı, dosyalar doğrudan libraries köküne dağılmamalıdır.

Manuel yerleştirmeden sonra Arduino IDE'yi yeniden aç. ZIP yöntemiyle kurulumda önce menü görünürlüğünü kontrol et; kütüphane görünmüyorsa IDE'yi kapatıp açarak kontrolü tekrarla. Kütüphane Library Manager'da bulunuyorsa Library Manager'ı seç. Elinde hazır bir ZIP arşivi varsa ZIP yöntemini kullan. Klasör yapısını kendin yönetmen gerekiyorsa manuel libraries klasörünü tercih et.

Kurulumu dört aşamada doğrula: örnek, #include ve derleme

Kurulumun tamamlandığını kontrol etmek için dört noktayı sırayla incele: kütüphanenin menüde görünmesi, örneğin açılması, doğru #include satırının ve başlatma çağrısının kullanılması, son olarak derleme.

1. Kütüphaneyi menüde bul: Kurulumdan sonra Sketch > Include Library altında kütüphane adını ara. Örnekleri varsa File > Examples menüsünde kütüphane başlığını da kontrol et.
2. İlgili örneği aç: File > Examples üzerinden kütüphaneye ait bir örnek seç. Örnekte hangi başlık dosyasının eklendiğine ve kütüphaneyi başlatmak için hangi çağrının kullanıldığına bak.
3. #include ve çağrıyı taşı: Örnekteki doğru #include satırını ve başlatma çağrısını kendi sketch'ine kontrollü biçimde aktar. Seçili kartın destek paketinde Wire kütüphanesi erişilebiliyorsa, kısa doğrulama iskeleti şöyledir:

   #include <Wire.h>
   
   void setup() {
     Wire.begin();
   }
   
   void loop() {
   }

   Bu iskelet fiziksel bir çıktı üretmeyi amaçlamaz. Beklenen sonuç, seçili kart bağlamında derleme hatası alınmamasıdır. Buradaki parametresiz Wire.begin() çağrısı, Wire kütüphanesinin I2C başlatma adımıdır.

4. Derle ve ilk hatayı değerlendir: Üst araç çubuğundaki Verify düğmesine veya menüdeki Sketch > Verify/Compile komutuna bas. Bu işlem sketch'i karta yüklemeden derler. Hata oluşursa en sondaki genel exit status 1 mesajına değil, önce dosya adı, satır numarası ve açıklama içeren ilk anlamlı hata satırına bak. Başarılı derlemede konsolda sketch boyutu ve bellek kullanımını bildiren sonuç görünür.

Benzer adlı kütüphanelerde üç adımlı hata teşhisi

Benzer ad taşıyan kütüphanelerde yalnızca Library Manager içindeki ada bakarak seçim yapma. Kayıt bilgisi, örnek dosyası, #include satırı ve derleme çıktısı aynı kütüphaneyi gösteriyorsa seçim daha güvenilir olur. Arduino IDE birden fazla eşleşme bulduğunda hangi klasörün kullanıldığını derleme çıktısında belirtebilir.

1. Kayıt adını ve klasörünü birlikte kontrol et

Tools > Manage Libraries… ile açılan Library Manager sonuçlarında adın yanında açıklamayı, yazarı ve varsa More info bilgisini karşılaştır. Ardından Sketch > Include Library altında görünen kaydı ve File > Examples altında açılan örneğin başlığını kontrol et. Bir kütüphanenin örnek içermemesi mümkündür. Bu nedenle örnek görünmemesi tek başına kurulumun başarısız olduğunu göstermez.

Fiziksel klasörü de kontrol et. Varsayılan Sketchbook konumlarında libraries klasörü Windows'ta C:Userskullanıcı_adıDocumentsArduinolibraries, macOS'ta /Users/kullanıcı_adı/Documents/Arduino/libraries, Linux'ta /home/kullanıcı_adı/Arduino/libraries yolundadır. Sketchbook farklı konuma ayarlanmışsa kendi Sketchbook'undaki libraries klasörünü esas al. ZIP'i açtıktan sonra libraries/Kutuphane/Kutuphane gibi iç içe bir yapı varsa, library.properties, src veya başlık dosyalarının ikinci klasörün içinde kalıp kalmadığını incele. Aynı adlı klasörleri hemen silmek yerine önce yolları ve içerikleri karşılaştır, yedek al; Arduino15 içindeki platform kütüphanelerini Sketchbook kopyasıyla karıştırma.

2. #include, harf duyarlılığı ve çağrıyı karşılaştır

Library Manager'daki kütüphane adı ile #include içindeki başlık dosyası aynı olmayabilir. Bu yüzden menüdeki ada değil, açılan örneğe göre ilerle. Örnekteki #include satırını, köşeli ayraçları, dosya adını, uzantıyı ve büyük ve küçük harfleri kendi kodunla birebir karşılaştır. Ardından çağrılan sınıf veya fonksiyon adını da kontrol et. Örnekteki ad ile kendi kodundaki ad arasında yalnızca bir harf farkı olması bile derleme hatasına yol açabilir.

3. En küçük örneği derle ve ilk anlamlı hatayı oku

Örneği açıp en küçük çalışan akışı derle. Örnek yoksa yeni bir sketch'te yalnız ilgili #include satırını, gerekli çağrıyı ve setup() ile loop() işlevlerini bırak. Verify sketch'i derler, Upload işlemi gibi karta aktarma adımına geçmez. Çıktının sonundaki exit status 1 gibi genel satırları değil, ondan önceki ilk açıklayıcı hata satırını oku. fatal error ve No such file or directory ifadelerini görürsen başlık dosyasının yazımını ve klasör yapısını yeniden kontrol et. Multiple libraries were found mesajı tek başına hata değildir. Used: yolunun beklediğin klasörü gösterip göstermediğine ve Not used: satırlarının başka kopyalara işaret edip etmediğine bak.

Arduino kütüphane kurulumu için dört maddelik kontrol listesi

Kurulum yönteminden bağımsız olarak son doğrulamayı şu dört noktada tamamlayabilirsin. Bu sıra, kütüphaneyi seçme, yerleştirme, #include kontrolü ve derleme adımlarını tek yerde toplar.

1. Doğru kütüphane kaydı ve kurulum yöntemi seçildi.
2. Library Manager kurulumu veya ZIP ya da manuel yerleştirme tamamlandı.
3. Include Library ya da örnek açılarak doğru #include doğrulandı.
4. Minimal kod Verify veya Compile ile hatasız derlendi.

Sık Sorulan Sorular

Library Manager'da aynı ada sahip birden fazla kütüphane varsa hangisini seçmeliyim?

Yalnızca ada göre karar verme. Açıklama ve yazar bilgisini, açılan örneğin #include satırını ve kullanılan sınıf veya fonksiyon adlarını karşılaştır. Derleme çıktısında Multiple libraries were found görülürse Used: satırındaki klasörün beklediğin kütüphaneyle eşleşip eşleşmediğini kontrol et.

ZIP ile eklediğim kütüphane Include Library menüsünde görünmüyorsa neyi kontrol etmeliyim?

Önce ZIP'in libraries altında doğru kök klasörle bulunduğunu ve Kutuphane/Kutuphane gibi iç içe bir yapı oluşmadığını kontrol et. Varsa library.properties dosyasının ve başlık dosyalarının beklenen kökte bulunduğuna bak, ardından Arduino IDE'yi yeniden başlat. File > Examples altında örnek görmemek tek başına belirleyici değildir, çünkü bazı kütüphaneler örnek içermez.

Kütüphane kurulduğu hâlde #include hatası alırsam ilk hangi üç adımı izlemeliyim?

Birinci adımda örnek koddaki #include satırını, dosya adını, uzantıyı ve büyük ve küçük harfleri kendi kodunla karşılaştır. İkinci adımda Sketchbook içindeki libraries klasörünü, kök klasörü ve varsa iç içe klasör yapısını incele. Üçüncü adımda en küçük örneği Verify ile derle; exit status 1 satırından önceki açıklayıcı hatayı ve Used: yolunu oku.

Kütüphane kurulumunu bu sırayla doğruladığında, ad sorunu ile klasör ve derleme sorununu birbirinden ayırarak daha düzenli ilerleyebilirsin.