Back to Localsend

LocalSend

support/readme/README_BE.md

1.18.217.5 KB
Original Source

LocalSend

Галоўная старонкаDiscordGitHubCodeberg

English (Default)БеларускаяEspañolفارسیFilipinoFrançaisIndonesiaItaliano日本語ភាសាខ្មែរ한국어PolskiPortuguês BrasilРусскийภาษาไทยTürkçeУкраїнськаTiếng Việt中文

LocalSend — гэта бясплатная праграма з адкрытым зыходным кодам, якая дазваляе бяспечна абменьвацца файламі і паведамленнямі з прыладамі побач праз лакальную сетку без інтэрнэт-злучэння.

Пра LocalSend

LocalSend — гэта кросплатформенная праграма для бяспечнай сувязі паміж прыладамі праз REST API і шыфраванне HTTPS. У адрозненне ад іншых праграм для абмену паведамленнямі, што абапіраюцца на знешнія серверы, LocalSend не патрабуе ні інтэрнэт-злучэння, ні старонніх сервераў, і таму з'яўляецца хуткім і надзейным рашэннем для лакальнай сувязі.

Спонсары

Тэсціраванне ў браўзерах забяспечвае

<a href="https://www.testmuai.com/?utm_medium=sponsor&utm_source=localsend" target="_blank"> </a>

Здымкі экрана

Спампаванне

Праграму раім спампоўваць з крамы праграм або праз менеджар пакетаў, бо яна не мае аўтаматычнага абнаўлення.

WindowsmacOSLinuxAndroidiOSFire OS
WingetApp StoreFlathubPlay StoreApp StoreAmazon
ScoopHomebrewNixpkgsF-Droid
ChocolateyDMG InstallerSnapAPK
EXE InstallerAUR
Portable ZIPTAR
DEB
AppImage

Падрабязней пра каналы распаўсюджвання.

Двайковыя файлы для Windows падпісаныя. Падрабязней у палітыцы падпісвання коду.

[!CAUTION] Неафіцыйная зборка MSIX: зборкі з апошніх камітаў можна паспрабаваць на localsend.ob-buff.dev. Стабільнасць не гарантуецца, а ўсе змяненні ў кодзе пералічаны на тым жа сайце.

Сумяшчальнасць

ПлатформаМінімальная версіяЗаўвага
Android5.0-
iOS12.0-
macOS11 Big SurСкарыстайцеся OpenCore Legacy Patcher 2.0.2 (гл. #1005)
Windows10Апошняя версія з падтрымкай Windows 7 — v1.15.4. У будучыні магчымы зваротныя порты навейшых версій для Windows 7.
LinuxН/ДЗалежнасці: Gnome: xdg-desktop-portal і xdg-desktop-portal-gtk, KDE: xdg-desktop-portal і xdg-desktop-portal-kde

Наладжванне

У большасці выпадкаў LocalSend працуе адразу пасля ўсталявання. Але калі ў вас узнікаюць цяжкасці з адпраўкай ці атрыманнем файлаў, магчыма, спатрэбіцца наладзіць міжсеткавы экран так, каб LocalSend мог абменьвацца данымі ў вашай лакальнай сетцы.

Тып трафікуПратаколПортДзеянне
УваходныTCP, UDP53317Дазволіць
ВыходныTCP, UDPЛюбыДазволіць

Таксама ўпэўніцеся, што на маршрутызатары адключана ізаляцыя пунктаў доступу. Звычайна яна адключана прадвызначана, але на некаторых маршрутызатарах можа быць уключана (асабліва ў гасцявых сетках). Падрабязней у раздзеле Выпраўленне непаладак.

Партатыўны рэжым

(з'явіўся ў v1.13.0)

Стварыце файл з назвай settings.json у той жа папцы, што і выканальны файл. Файл можа быць пусты. Праграма будзе захоўваць налады ў ім замест прадвызначанага месца.

Схаваны запуск

(абноўлена ў v1.15.0)

Каб запусціць праграму схавана (толькі ў вобласці апавяшчэнняў), скарыстайцеся параметрам --hidden (напрыклад: localsend_app.exe --hidden).

У версіях v1.14.0 і ранейшых праграма запускаецца схавана, калі зададзены параметр autostart і ўключана налада схаванага запуску.

Як гэта працуе

LocalSend выкарыстоўвае бяспечны пратакол сувязі, які дазваляе прыладам абменьвацца данымі праз REST API. Усе даныя перадаюцца праз HTTPS, а сертыфікат TLS/SSL ствараецца на ляту на кожнай прыладзе, што забяспечвае максімальную бяспеку.

Падрабязней пра пратакол LocalSend — у дакументацыі.

Іерархія залежнасцей

Пачатак працы

Каб сабраць LocalSend з зыходнага коду, выканайце наступныя крокі:

  1. Усталюйце Flutter напрамую або праз fvm (гл. патрэбную версію)
  2. Усталюйце Rust
  3. Кланіруйце рэпазіторый LocalSend
  4. Выканайце cd app, каб перайсці ў папку праграмы
  5. Выканайце flutter pub get, каб спампаваць залежнасці
  6. Выканайце flutter run, каб запусціць праграму

[!NOTE] Цяпер LocalSend патрабуе старэйшай версіі Flutter (яна ўказана ў .fvmrc), таму праблемы са зборкай могуць узнікаць з-за неадпаведнасці паміж патрэбнай версіяй і той, што ўсталявана ў сістэме.
Каб распрацоўка была больш прадказальнай, LocalSend кіруе версіяй Flutter праз fvm. Пасля ўсталявання fvm выконвайце fvm flutter замест flutter.

Унёсак у праект

Мы вітаем унёсак ад кожнага, хто хоча дапамагчы палепшыць LocalSend. Далучыцца можна некалькімі спосабамі.

Пераклад

Вы можаце дапамагчы з перакладам LocalSend на іншыя мовы. Для кіравання перакладамі мы карыстаемся платформай Weblate.

Акрамя таго, можна зрабіць развілку (fork) гэтага рэпазіторыя і дадаць пераклады ўручную.

Пераклады знаходзяцца ў папцы app/assets/i18n. Каб дадаць ці абнавіць пераклад, рэдагуйце файл _missing_translations_<locale>.json або <locale>.json.

<a href="https://hosted.weblate.org/engage/localsend/"> </a>

Заўвага: палі, пазначаныя @, перакладаць не трэба; праграма іх ніяк не выкарыстоўвае, гэта проста звесткі пра файл або кантэкст для перакладчыка.

Выпраўленне памылак і паляпшэнні

  • Выпраўленне памылак: калі вы знайшлі памылку, стварыце запыт на зліванне (pull request) з выразным апісаннем праблемы і спосабу яе выпраўлення.
  • Паляпшэнні: маеце ідэю, як палепшыць LocalSend? Спачатку стварыце паведамленне пра праблему (issue), каб абмеркаваць, навошта гэта паляпшэнне патрэбна.

Падрабязней — у дапаможніку па ўнёску ў праект.

Выпраўленне непаладак

ПраблемаПлатформа (адпраўка)Платформа (атрыманне)Рашэнне
Прылада не бачнаяЛюбаяЛюбаяУпэўніцеся, што на маршрутызатары адключана ізаляцыя пунктаў доступу. Калі яна ўключана, злучэнні паміж прыладамі забаронены.
Прылада не бачнаяЛюбаяWindowsУпэўніцеся, што сетка наладжана як «прыватная». Для сетак, наладжаных як агульнадаступныя, Windows можа быць больш строгай.
Прылада не бачнаяmacOS, iOSЛюбаяПаспрабуйце пераключыць дазвол «Лакальная сетка» ў раздзеле «Прыватнасць» у наладах сістэмы.
Занадта нізкая хуткасцьЛюбаяЛюбаяКарыстайцеся 5 ГГц; адключыце шыфраванне на абедзвюх прыладах
Занадта нізкая хуткасцьЛюбаяAndroidВядомая праблема. https://github.com/flutter-cavalry/saf_stream/issues/4

Зборка

Гэтыя каманды прызначаны толькі для тых, хто вядзе праект. Выконвайце іх з папкі app.

Android

Звычайны APK

bash
flutter build apk

AppBundle для Google Play

bash
flutter build appbundle

iOS

bash
flutter build ipa

macOS

bash
flutter build macos

Windows

Звычайная

bash
flutter build windows

Лакальная праграма MSIX

bash
flutter pub run msix:create

Гатовая для крамы

bash
flutter pub run msix:create --store

Linux

Звычайная

bash
flutter build linux

AppImage

bash
appimage-builder --recipe AppImageBuilder.yml

Snap

Інструкцыі ў localsend/snap/README.md

Суаўтары

<a href="https://github.com/localsend/localsend/graphs/contributors"> </a>