Adım adım rehber

SkyyDesk'i uygulamanıza adım adım ekleyin

Bu rehberde boş bir .NET uygulamasına SkyyDesk'i ekliyor, sonra başka bir bilgisayardan ona bağlanıyoruz. Her adımda yazacağınız komut ve ekranda görmeniz gereken şey var. Görüntülerin hepsi bu rehberi hazırlarken yaptığımız gerçek denemeden.

Önce nasıl çalıştığını görün

  1. Sizin uygulamanızİçinde SkyyDesk kütüphanesi var. Makineye bir kimlik alır, gelen isteği size sorar.
  2. SkyyDesk sunucularıİki tarafı buluşturur ve görüntüyü taşır. Hesaplar, adres defterleri ve lisans burada.
  3. Bağlanan kişiskyydesk.com'dan tarayıcıyla ya da SkyyDesk uygulamasıyla, kendi hesabıyla bağlanır.
  1. Uygulamanız açılır.Kütüphane sunucuya bağlanır ve makineye 9 haneli bir kimlik alır. Kayıt anahtarı verdiyseniz makine adres defterinize de yazılır.
  2. Biri bağlanmak ister.Kimliği skyydesk.com'a yazar ya da panelde adres defterinden tıklar.
  3. Uygulamanız karar verir.İstek uygulamanıza bir olay olarak gelir. Siz kabul etmeden kimse içeri giremez.
  4. Ekran akar.Bağlanan kişi bu makinenin ekranını görür, fare ve klavyesi burada çalışır.

Kütüphanede kullanıcı girişi yok. Bağlanan kişi kendi SkyyDesk hesabı ve lisansıyla girer; uygulamanız yalnız kapıyı açar ya da kapalı tutar.

Başlamadan önce

Adım adım

  1. Panelde bir kayıt anahtarı üretin

    skyydesk.com'da Giriş'e tıklayıp hesabınızla girin. Soldaki menüden Ayarlar'ı açın ve sayfanın altındaki Kayıt anahtarları kartına inin. Anahtara tanıyacağınız bir ad verin, örneğin "Mağaza kasaları", ve Anahtar oluştur'a basın.

    Panelde Ayarlar sayfası, altta Kayıt anahtarları kartı
    Panel, Ayarlar, en altta Kayıt anahtarları.

    Anahtar yalnız bu an, bir kez gösterilir. Kopyala'ya basıp bir yere kaydedin. Kaybederseniz yenisini üretirsiniz.

    sdk_ ile başlayan yeni anahtar ve Kopyala düğmesi
    Görmeniz gereken: sdk_ ile başlayan anahtar ve listede "Etkin" yazan satır.

    Bu adım isteğe bağlı. Anahtarsız da çalışır; o zaman makine adres defterinize kendiliğinden düşmez, kimliğini elle yazarak bağlanırsınız.

  2. NuGet paketini indirin

    Geliştiriciler sayfasından .NET paketini indirin. Paket nuget.org'da değil. Çalışma klasörünüzde paketler adında bir klasör açıp dosyayı içine koyun:

    Klasör
    calisma/
    ├── paketler/
    │   └── SkyyDesk.1.4.10.nupkg
    └── Uygulamam/        ← 3. adımda oluşacak
  3. Paketi uygulamanıza ekleyin

    Terminali açın (Windows'ta PowerShell ya da Visual Studio'daki Terminal penceresi), çalışma klasörüne geçin ve bu üç komutu yazın. Var olan bir projeniz varsa yalnız sonuncusunu, projenizin klasöründe çalıştırın.

    Terminal
    dotnet new console -o Uygulamam
    cd Uygulamam
    dotnet add package SkyyDesk --source ../paketler
    Terminalde dotnet add package çıktısı
    Görmeniz gereken: "PackageReference for package 'SkyyDesk' version '1.4.10' added" ve en altta "Restored". Linux'taki X.509 satırları .NET'in kendi bilgi notu.

    Paket, kütüphaneyi derleme çıktısına kendisi kopyalar: Windows'ta skyydesk.dll ve yanındaki DLL'ler, Linux'ta libskyydesk.so. Elle bir şey kopyalamazsınız.

  4. Program.cs dosyasını yazın

    Program.cs'nin içini silin ve bunu yapıştırın. Paketin içindeki examples/dotnet/Program.cs ile aynı dosya.

    Program.cs
    using SkyyDesk;
    
    var desk = new SkyyDeskHost(Path.Combine(AppContext.BaseDirectory, "skyydesk-data"));
    desk.Incoming += (_, c) =>
    {
        if (c.Authorized) return;
        Console.Write($"{c.Name} ({c.PeerId}) wants to connect. Allow? [y/N] ");
        if (Console.ReadKey().KeyChar is 'y' or 'Y') desk.Accept(c.Id); else desk.Close(c.Id);
        Console.WriteLine();
    };
    desk.Closed += (_, id) => Console.WriteLine($"connection {id} closed");
    desk.Enrolled += (_, r) => Console.WriteLine(r.Ok ? "added to the address book" : $"enroll failed: {r.Error}");
    
    if (args.Length > 0) desk.SetEnrollKey(args[0]);
    desk.Start(allowPassword: true);
    Console.WriteLine($"SkyyDesk ID {desk.MyId}, one-time password {desk.OneTimePassword}");
    Thread.Sleep(Timeout.Infinite);

    Satır satır ne yapıyor:

    new SkyyDeskHost(...)
    Kütüphaneyi başlatır. Programın en başında, her şeyden önce durmalı: kütüphane kendi yardımcı işleri için uygulamanızın kopyalarını açar ve o kopyalar bu satırda kapanır.
    Incoming
    Biri bağlanmak istediğinde çalışır. Authorized false ise kişi onay bekliyor: Accept(c.Id) içeri alır, Close(c.Id) reddeder.
    Closed
    Bağlantı bittiğinde çalışır.
    Enrolled
    Kayıt anahtarının sonucunu söyler: makine adres defterine eklendi ya da neden eklenmedi.
    SetEnrollKey
    1. adımdaki anahtarı verir. Anahtar makinede saklanır; sonraki açılışlarda yeniden vermeniz gerekmez.
    Start
    Makineyi bağlanılabilir yapar. allowPassword: true iken tek kullanımlık parolayı bilen onay beklemeden girer. Herkes onayla girsin istiyorsanız false yazın.
    MyId
    Makinenin kimliği. Bağlanacak kişiye bunu gösterin.
  5. Uygulamayı çalıştırın

    Anahtarı komutun sonuna yazarak çalıştırın:

    Terminal
    dotnet run -- sdk_anahtariniz
    Uygulama kimliği ve adres defterine eklendiğini yazıyor
    Görmeniz gereken: "SkyyDesk ID" satırında 9 haneli kimlik ve altında "added to the address book".

    Uygulama açık kaldığı sürece makineye bağlanılabilir.

  6. Başka bir bilgisayardan bağlanın

    İkinci bilgisayarda skyydesk.com'u açın. Kimliği Hemen Bağlan kutusuna yazın ve Bağlan'a basın. Oturum yeni bir sekmede açılır ve onay bekler.

    skyydesk.com ana sayfasında kimlik yazılmış Hemen Bağlan kutusu
    skyydesk.com ana sayfası, Hemen Bağlan.
    Oturum sayfası: karşı taraftan onay bekleniyor
    Görmeniz gereken: kimlik ve altında "Karşı taraftan onay bekleniyor".
  7. Uygulamada onay verin

    Aynı anda uygulamanızda Incoming olayı çalışır. Örnek uygulama terminalde kimin bağlanmak istediğini sorar. y tuşuna basın.

    Terminalde: wants to connect. Allow? [y/N]
    Görmeniz gereken: "wants to connect. Allow? [y/N]". Satırın başında bağlanan kişinin hesap adı yazar; görüntüde biz gizledik.
  8. Ekran gelir

    Onaydan birkaç saniye sonra bağlanan kişi bu makinenin ekranını görür, fare ve klavyeyle kullanır. Aşağıda uygulamanın çalıştığı makinenin kendi ekranı var: terminaldeki "y" de bu ekrandan geliyor.

    Tarayıcıdaki oturumda uzak makinenin ekranı
    Görmeniz gereken: üstte araç çubuğu, altında karşı makinenin canlı ekranı.

    Oturumu kapatınca uygulamada Closed olayı çalışır ve terminal "connection ... closed" yazar.

  9. Makineyi adres defterinizde bulun

    Panelde Adres Defteri'ni açın. Kayıt anahtarı verdiğiniz makine Grupsuz başlığının altında, adı ve kimliğiyle durur; açıksa "Çevrimiçi" yazar. Bir dahaki sefere kimlik yazmadan buradan bağlanırsınız ve makineyi bir gruba taşıyabilirsiniz.

    Panelde Adres Defteri, makine çevrimiçi
    Görmeniz gereken: makinenin adı, kimliği ve "Çevrimiçi".

Kendi uygulamanıza taşırken

Başka dillerde

C, Java ve Delphi aynı C işlevlerini çağırır. Windows zip'ini ya da Linux tar.gz'yi açın; örnekler examples klasöründe.

Linux paketinin içi: kütüphane, başlık, README ve örnekler
Linux paketinin içi. Windows zip'inde libskyydesk.so yerine skyydesk.dll ve yanındaki DLL'ler var.
DilNasıl derlenirÖrnek
CWindows: cl host.c skyydesk.lib
Linux: cc host.c -o host -L. -lskyydesk -Wl,-rpath,'$ORIGIN'
examples/c/host.c
JavaJNA 5.x ile; JNI kodu derlenmez. Kütüphaneyi uygulamanın yanına koyun.examples/java/SkyyDeskHost.java
DelphiSkyyDesk.pas birimini projeye ekleyin.examples/delphi/Host.dpr

C örneği de .NET örneği gibi davranır: kimliği yazar, bağlantı isteğinde "allow connection N? [y/N]" diye sorar.

Sık sorunlar

Ne görüyorsunuzSebebiNe yapın
Windows'ta bağlantı kuruluyor ama ekran gelmiyorMakinede açık bir Windows oturumu yok, ya da Uzak Masaüstü (RDP) penceresi kapatılıp oturum kopuk kalmış. Windows bu durumda ekran vermez.Makinede kullanıcı oturumunu açık tutun.
Kayıt olayında "Kayıt anahtarı geçersiz ya da iptal edilmiş."Anahtar panelde iptal edilmiş ya da eksik kopyalanmış.Panelden yeni anahtar üretip verin. Anahtar kullanmayacaksanız SetEnrollKey("") ile temizleyin.
C'de skyydesk_start -2 dönüyorOlay geri çağrısı verilmemiş. Kimsenin görmediği bir bağlantıya izin verilmez.Önce skyydesk_set_event_callback çağırın.
Linux'ta kütüphane yüklenmiyor (DllNotFoundException ya da "cannot open shared object file")Kütüphanenin istediği sistem paketleri eksik.Aşağıdaki komutu çalıştırın. Ubuntu 24.04 ve sonrasında libgtk-3-0t64 ve libasound2t64 yazın.
Bağlanan kişi makineye ulaşamıyorMakine SkyyDesk sunucularına çıkamıyor.Güvenlik duvarında rs.skyydesk.com için TCP 21115–21117 ve UDP 21116'yı açın.
Linux'ta her bağlantıda ekran paylaşımı onayı soruluyorMasaüstü Wayland ile çalışıyor.Onay verin ya da oturumu X11 ile açın.
Debian / Ubuntu
sudo apt install libgtk-3-0 libxcb-randr0 libxdo3 libxfixes3 libxcb-shape0 libxcb-xfixes0 \
  libasound2 libsystemd0 libva2 libva-drm2 libva-x11-2 libgstreamer-plugins-base1.0-0 \
  libpam0g gstreamer1.0-pipewire libpulse0

Bütün işlevler

.NET paketi bu C işlevlerinin üstünde ince bir katman. Olayların listesi geliştiriciler sayfasında.

C.NETNe yaparNe döner
skyydesk_initnew SkyyDeskHost(dir)Kütüphaneyi başlatır. main'in ilk satırı.0; klasör verilmezse -1
skyydesk_set_event_callbackIncoming, Closed, Enrolled olaylarıOlayların geleceği işlevi verir.–
skyydesk_startStart(allowPassword)Makineyi bağlanılabilir yapar. 0 verilirse her bağlantı onay bekler.0; geri çağrı yoksa -2 (.NET'te hata fırlatır)
skyydesk_my_idMyIdMakinenin kimliği.uzunluk; yer yetmezse -1
skyydesk_acceptAccept(id)Bekleyen bağlantıyı içeri alır.–
skyydesk_closeClose(id)Bağlantıyı reddeder ya da keser.–
skyydesk_passwordOneTimePasswordGeçerli tek kullanımlık parola.uzunluk; yer yetmezse -1
skyydesk_new_passwordNewOneTimePassword()Yeni tek kullanımlık parola üretir.–
skyydesk_set_passwordSetPassword(pw)Kalıcı parola verir; boş metin kaldırır.0 ya da -1 (.NET'te true/false)
skyydesk_get_optionGetOption(key)Bir ayarı okur.uzunluk
skyydesk_set_optionSetOption, SetEnrollKeyBir ayarı yazar. Sunucu ve hesap ayarları reddedilir.0; reddedilirse -1

Paketler ve kısa özet geliştiriciler sayfasında.

Paketleri indir Panele gir